Skip to content
Simple cross platform GUI for rclone
C++ CMake Batchfile Shell Python Objective-C++ C
Branch: master
Clone or download
Pull request Compare This branch is 83 commits ahead of DinCahill:master.
Latest commit 8d3b760 Sep 27, 2019

README.md

RcloneBrowser

Downloads Release License Donate

alt text

Simple cross platfrom GUI for rclone command line tool.

Supports macOS, GNU/Linux and Windows.

Features

  • Allows to browse and modify any rclone remote, including encrypted ones
  • Uses same configuration file as rclone, no extra configuration required
  • Supports custom location and encryption for .rclone.conf configuration file
  • Simultaneously navigate multiple repositories in separate tabs
  • Lists files hierarchically with file name, size and modify date
  • All rclone commands are executed asynchronously, no freezing GUI
  • File hierarchy is lazily cached in memory, for faster traversal of folders
  • Allows to upload, download, create new folders, rename or delete files and folders
  • Allows to calculate size of folder, export list of files and copy rclone copmmand to clipboard
  • Can process multiple upload or download jobs in background
  • Drag & drop support for dragging files from local file explorer for uploading
  • Streaming media files for playback in player like vlc or similar
  • Mount and unmount folders on macOS, GNU/Linux and Windows (for Windows requires winfsp)
  • Optionally minimizes to tray, with notifications when upload/download finishes
  • Supports portable mode (create .ini file next to executable with same name), rclone and .rclone.conf path now can be relative to executable
  • Supports drive-shared-with-me (Google Drive specific)
  • For remotes supporting public link sharing has an option (right-click menu) to fetch it
  • Supports tasks. Created jobs can be saved and run or edited later.

Below sample screenshots:

macOS

alt text alt text

Linux

alt text

alt text

Windows

alt text

alt text

Download

Get Windows, macOS and Ubuntu/Debian package on releases page.

All released binaries are signed with my PGP key.

ArchLinux users can install latest release from AUR repository: rclone-browser. It has been updated to this repo.

Other GNU/Linux users will need to build from source. Actually in my opinion for Linux it is the best option and is real easy. Below are detailed instructions.

Build instructions for Debian/Ubuntu Linux

  1. Install dependencies sudo apt install git rclone g++ cmake qtbase5-dev
  2. Clone source code from this repo git clone https://github.com/kapitainsky/RcloneBrowser.git
  3. Go to source folder cd RcloneBrowser
  4. Create new build folder next to src folder - mkdir build && cd build
  5. Run cmake .. from build folder to create makefile
  6. Run cmake --build . from build folder to create binary

Build instructions for openSUSE linux

  1. Install dependencies sudo zypper install git cmake gcc-c++ rclone libQt5Core-devel libQt5Widgets-devel
  2. Clone source code from this repo git clone https://github.com/kapitainsky/RcloneBrowser.git
  3. Go to source folder cd RcloneBrowser
  4. Create new build folder next to src folder - mkdir build && cd build
  5. Run cmake .. from build folder to create makefile
  6. Run cmake --build . from build folder to create binary

Build instructions for macOS

  1. If you don't have Homebrew yet install it /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
  2. Install dependencies brew install git cmake rclone qt5
  3. Set Qt environment variables export PATH="/usr/local/opt/qt/bin:$PATH" && export LDFLAGS="-L/usr/local/opt/qt/lib" && export CPPFLAGS="-I/usr/local/opt/qt/include" && export PKG_CONFIG_PATH="/usr/local/opt/qt/lib/pkgconfig". You can add this to your .bashrc (assuming you use bash) if you want to keep it persistent
  4. Clone source code from this repo git clone https://github.com/kapitainsky/RcloneBrowser.git
  5. Go to source folder cd RcloneBrowser
  6. Create new build folder next to src folder - mkdir build && cd build
  7. Run cmake .. from build folder to create makefile
  8. Run cmake --build . from build folder to create binary
  9. Go to yet another newly created build folder cd build. Your binary should be here
  10. Package your binary with Qt libraries to create self-contained application macdeployqt rclone-browser.app -executable="rclone-browser.app/Contents/MacOS/rclone-browser" -qmldir=../src/. Without this step binary won't work without Qt installed

Build instructions for Windows

  1. Get Visual Studio 2019 - you need "Desktop development with C++" module only
  2. Install CMake
  3. Install latest Qt v5 (64-bit) from Qt website. You only need "Qt 5.13.1 Prebuilt Components for MSVC 2017 64-bit" (MSVC 2017 64-bit)
  4. Get rclone-browser source code. You either need to install git and clone it or download zip file from releases
  5. Go to source folder cd RcloneBrowser
  6. Create new build folder - mkdir build and go there cd build
  7. run cmake -G "Visual Studio 16 2019" -A x64 -DCMAKE_CONFIGURATION_TYPES="Release" -DCMAKE_PREFIX_PATH=/c/Qt/5.13.1/msvc2017_64 .. && cmake --build . --config Release
  8. run c:\Qt\5.13.1\msvc2017_64\bin\windeployqt.exe --no-translations --no-angle --no-compiler-runtime --no-svg ".\build\Release\RcloneBrowser.exe"
  9. build\Release folder contains now RcloneBrowser.exe binary and all other files required to run it.

History

Being rclone-browser user for some time and got annoyed by small not working bits and pieces I decided for DYI approach and this is how this repo was created. Original repo (https://github.com/mmozeiko/RcloneBrowser) has not been touched for years and in the meantime rclone changed few things breaking some rclone-browser functionality.

I've looked around but could not find anything fully working. Some github users made progress in fixing and adding stuff so I've built upon it.

I used DinCahill's changes (https://github.com/DinCahill/RcloneBrowser) as a base of my version.

I have fixed whatever I found still not working and added few minor tweaks. I've recompiled and repackaged everything using latest Qt (5.13.1). This on its own fixed some issues and added new features like support for dark mode in macOS.

Donations

And if you enjoy my work you can always buy me a beer:)

https://www.paypal.me/kapitainsky

License

This is free and unencumbered software released into the public domain.

Anyone is free to copy, modify, publish, use, compile, sell, or distribute this software, either in source code form or as a compiled binary, for any purpose, commercial or non-commercial, and by any means.

You can’t perform that action at this time.