1<img src="https://github.com/kapitainsky/RcloneBrowser/wiki/images/RcloneBrowserLongLogo1.png" width="80%" /> 2 3[![Travis CI Build Status][img1]][1] [![AppVeyor Build Status][img2]][2] [![Downloads][img3]][3] [![Release][img4]][4] <img src="https://img.shields.io/badge/Qt-cmake-green.svg"> [](https://www.codacy.com/manual/kapitainsky/RcloneBrowser?utm_source=github.com&utm_medium=referral&utm_content=kapitainsky/RcloneBrowser&utm_campaign=Badge_Grade) [![License][img5]][5] [](https://www.paypal.me/kapitainsky) 4 5Rclone browser 6============== 7Simple cross platfrom GUI for [rclone](https://rclone.org/) command line tool. 8 9Supports macOS, GNU/Linux, BSD family and Windows. 10 11Table of contents 12------------------- 13* [Features](https://github.com/kapitainsky/RcloneBrowser#features) 14* [Sample screenshots](https://github.com/kapitainsky/RcloneBrowser#sample-screenshots) 15* [How to get it](https://github.com/kapitainsky/RcloneBrowser#how-to-get-it) 16* [Why AppImage only for Linux](https://github.com/kapitainsky/RcloneBrowser#why-appimage-only-for-linux) 17* [Build instructions](https://github.com/kapitainsky/RcloneBrowser#build-instructions) 18 * [Linux](https://github.com/kapitainsky/RcloneBrowser#linux) 19 * [FreeBSD](https://github.com/kapitainsky/RcloneBrowser#freebsd) 20 * [OpenBSD](https://github.com/kapitainsky/RcloneBrowser#openbsd) 21 * [NetBSD](https://github.com/kapitainsky/RcloneBrowser#netbsd) 22 * [macOS](https://github.com/kapitainsky/RcloneBrowser#macos) 23 * [Windows](https://github.com/kapitainsky/RcloneBrowser#windows) 24* [Portable vs standard mode](https://github.com/kapitainsky/RcloneBrowser#portable-vs-standard-mode) 25* [History](https://github.com/kapitainsky/RcloneBrowser#history) 26* [Code signing certificates donations](https://github.com/kapitainsky/RcloneBrowser#code-signing-certificates-donations) 27 28Features 29-------- 30* Allows to browse and modify any rclone remote, including encrypted ones 31* Uses same configuration file as rclone, no extra configuration required 32* Supports custom location and encryption for rclone.conf configuration file 33* Simultaneously navigate multiple repositories in separate tabs 34* Lists files hierarchically with file name, size and modify date 35* All rclone commands are executed asynchronously, no freezing GUI 36* File hierarchy is lazily cached in memory, for faster traversal of folders 37* Allows to upload, download, create new folders, rename or delete files and folders 38* Allows to calculate size of folder, export list of files and copy rclone command to clipboard 39* Can process multiple upload or download jobs in background 40* Drag & drop support for dragging files from local file explorer for uploading 41* Streaming media files for playback in player like [vlc][6] or similar 42* Mount and unmount folders on macOS, GNU/Linux and Windows (for Windows requires [winfsp](http://www.secfs.net/winfsp/) and for mac [fuse for macOS](https://osxfuse.github.io/)) 43* Optionally minimizes to tray, with notifications when upload/download finishes 44* Supports portable mode (create .ini file next to executable with same name), rclone and rclone.conf path now can be relative to executable 45* Supports drive-shared-with-me (Google Drive specific) 46* For remotes supporting public link sharing has an option (right-click menu) to fetch it 47* Supports tasks. Created jobs can be saved and run or edited later. 48* Configurable dark mode for all systems 49 50Sample screenshots 51------------------- 52**macOS** 53<p align="center"> 54<img src="https://github.com/kapitainsky/RcloneBrowser/wiki/images/screenshot24.png" width="100%" /> 55<img src="https://github.com/kapitainsky/RcloneBrowser/wiki/images/screenshot23.png" width="75%" /> 56</p> 57 58**Linux** 59<p align="center"> 60<img src="https://github.com/kapitainsky/RcloneBrowser/wiki/images/screenshot21.png" width="65%" /> 61</p> 62 63<p align="center"> 64<img src="https://github.com/kapitainsky/RcloneBrowser/wiki/images/screenshot22.png" width="65%" /> 65</p> 66 67 68**Windows** 69<p align="center"> 70<img src="https://github.com/kapitainsky/RcloneBrowser/wiki/images/screenshot25.PNG" width="100%" /> 71</p> 72 73<p align="center"> 74<img src="https://github.com/kapitainsky/RcloneBrowser/wiki/images/screenshot26.PNG" width="65%" /> 75</p> 76 77 78 79How to get it 80-------------- 81Get binaries for Windows, macOS and Linux on [releases][3]' page. 82 83Windows installers (64-bit and 32-bit) are compatible with all x86 based Windows OS starting with Windows 7. If for whatever reason somebody would prefer not to run installer all files can be extracted using [innoextract](https://constexpr.org/innoextract/). 84 85Mac version is compiled to run on all versions of macOS starting with 10.9. 86 87Situation with Linux is a bit fuzzier... 88Linux binary ([AppImage](https://appimage.org/)) for armhf architecture runs on any Raspberry Pi hardware using Raspbian based on Stretch or Buster. 89 90Linux binaries (AppImage) for x86_64 and i386 architectures should run on systems using distributions released in the last few years. x86_64 one is built on CentOS 7 (released in 2014) and i386 on Ubuntu 16.04 LTS (released in 2016). 91 92The whole idea with AppImage is to build it on the oldest still supported LTS distro – and it should work on all newer OS releases. AppImage contains an aplication and all the files the app needs to run. In other words, each AppImage has no dependencies other than what is included in the base operating system. 93 94In practical terms it means that for example for Ubuntu Rclone Browser AppImage works on all versions starting with 16.04 LTS and for Debian starting with Stretch. With other distributions YMMV but I test major ones like Suse or Fedora. This is Linux. 10000 different distributions… with changes and customizations often only their authors are aware of. I would be happy to hear what distribution it does not work for. 95 96To make life easier when using AppImages on Linux, you can use [AppImageLauncher](https://github.com/TheAssassin/AppImageLauncher) which monitors your system for downloaded AppImages and provides several useful benefits including: 97 98* **AppImage desktop integration** - AppImageLauncher allows you to integrate AppImages you download into your application menu or launcher to make it easier for you to launch them. It also takes care of moving them into a central location, where you can find them later if you need access to them again. 99 100* **Update management** - AppImageLauncher provides a simple to use update mechanism. After desktop integration, the context menu of the AppImage's entry in the application launcher will have an entry for updating that launches a little helper tool that uses AppImageUpdate internally. Just click the entry and have the tool search and apply updates. 101 102* **Easy removal of AppImages from system** - Removing integrated AppImages is pretty simple, too. Similar to updating AppImages, you will find an entry in the context menu in the application launcher that triggers a removal tool. You will be asked to confirm the removal. If you choose to do so, the desktop integration is undone, and the file is removed from your system. 103 104For all released binaries file with hashes signed with my [PGP key](https://github.com/kapitainsky/RcloneBrowser/wiki/PGP-key) is provided. It allows to verify that provided binaries were created by myself (authenticity) and are unchanged (integrity). If you would like to have properly signed releases with code signing certificates please see note at the end of this section. 105 106ArchLinux users can install latest release from AUR repository: [rclone-browser][7]. 107 108Fedora package is now available from [Fedora packages](https://apps.fedoraproject.org/packages/rclone-browser) - simply run `sudo dnf install rclone-browser` 109 110FreeBSD has its version available from [freshports](https://www.freshports.org/net/rclone-browser) website. 111 112*Note: For Windows and macOS it would be much nicer (to avoid pop ups about unknown software origin) to properly sign released packages with code signing certificates however it does not come free even for open source software. I looked at it and it seems that to get keys for both systems for the next three years would cost about $500 (3x$99 for [Apple developer account](https://developer.apple.com/support/purchase-activation/) and $200 for cheapest Comodo [code signing certificate](https://comodosslstore.com/uk/code-signing). I am not prepared to budget it as I do this only as a hobby and I am entirely happy with this software as it is. If Rclone Browser users think that properly signed software would be beneficial for them they can [chip in](https://www.paypal.me/kapitainsky) some cash for it. If I raise required amount I will get keys. If not I will give money to some charity.* 113 114Why AppImage only for Linux 115---------------------------- 116Starting with version 1.7.0 Linux binaries are only available in [AppImage](https://appimage.org/) format. Some explanation on this... 117 118Binaries for Linux desktop applications is a major f*ing pain in the ass... as Linus Torvalds said - [DebConf 14_ QA](https://www.youtube.com/watch?v=5PmHRSeA2c8) at 05:40: 119 120> I'm talking about actual application writers that want to make a package of their application for Linux. And I've seen this firsthand with the other project I've been involved with, which is my divelog application. 121> We make binaries for Windows and OS X. 122 123He is talking about [Subsurface](https://subsurface-divelog.org). His small side project. 124 125> We basically don't make binaries for Linux. Why? Because binaries for Linux desktop applications is a major f*ing pain in the ass. Right. You don't make binaries for Linux. You make binaries for Fedora 19, Fedora 20, maybe there's even like RHEL 5 from ten years ago, you make binaries for debian stable. 126> Or actually you don't make binaries for debian stable because debian stable has libraries that are so old that anything that was built in the last century doesn't work. But you might make binaries for debian... whatever the codename is for unstable. And even that is a major pain because (...) debian has those rules that you are supposed to use shared libraries. Right. 127> 128> And if you don't use shared libraries, getting your package in, like, is just painful. 129> But using shared libraries is not an option when the libraries are experimental and the libraries are used by two people and one of them is crazy, so every other day some ABI breaks. 130> So you actually want to just compile one binary and have it work. Preferably forever. And preferably across all Linux distributions. 131> And I actually think distributions have done a horribly, horribly bad job. 132> 133> One of the things that I do on the kernel - and I have to fight this every single release and I think it's sad - we have one rule in the kernel, one rule: we don't break userspace. (...) People break userspace, I get really, really angry. (...) 134> And then all the distributions come in and they screw it all up. Because they break binary compatibility left and right. 135> They update glibc and everything breaks. (...) 136> So that's my rant. And that's what I really fundamentally think needs to change for Linux to work on the desktop because you can't have applications writers to do fifteen billion different versions. 137 138And I totally agree with above. I want to provide binary which works across as many Linux distributions as possible and I dont have time to fight with all mess with different dependencies etc. There are other similar ditribution formats e.g. flatpak but I had to choose one and I decided that AppImage is my best choice. I am not saying that AppImage is the best one but it nicely fits my objectives. You can see comparison of different solutions [here](https://github.com/AppImage/AppImageKit/wiki/Similar-projects#comparison). 139 140If for whatever reason you are not happy or your system is not covered with provided binaries you can easily build Rclone Browser for yourself. Especially on Unix-like systems it is very easy. Please see below step by step instructions for major operating systems. I have tested all of them and you can have your own Linux distribution Rclone Browser running in no time - it takes 8 min on Raspberry Pi 3B+, on modern desktop it can be less than a minute. 141 142Build instructions 143------------------ 144 145### Linux 1461. Install dependencies for your particular distribution: 147 * **Debian/Ubuntu and derivatives**: `sudo apt update && sudo apt -y install git g++ cmake make qtdeclarative5-dev` 148 * **Suse/OpenSuse**: `sudo zypper ref && sudo zypper --non-interactive install git cmake make gcc-c++ libQt5Core-devel libQt5Widgets-devel libQt5Network-devel` 149 * **RHEL/CentOS**: `sudo yum -y install git gcc-c++ cmake make qt5-qtdeclarative` 150 * **Fedora**: `sudo dnf -y install git g++ cmake make qt5-qtdeclarative-devel` 151 * **Arch/Manjaro**: `sudo pacman -Sy --noconfirm --needed git gcc cmake make qt5-declarative` 1522. Clone source code from this repo `git clone https://github.com/kapitainsky/RcloneBrowser.git` 1533. Go to source folder `cd RcloneBrowser` 1544. Create new build folder - `mkdir build && cd build` 1555. Run `cmake ..` from build folder to create makefile 1566. Run `make` from build folder to create binary 1577. Install `sudo make install` 158 159### FreeBSD 1601. Install dependencies `sudo pkg install git cmake qt5-buildtools qt5-declarative qt5-qmake` 1612. Clone source code from this repo `git clone https://github.com/kapitainsky/RcloneBrowser.git` 1623. Go to source folder `cd RcloneBrowser` 1634. Create new build folder - `mkdir build && cd build` 1645. Run `cmake ..` from build folder to create makefile 1656. Run `make` from build folder to create binary 1667. Install `sudo make install` 167 168*Note: For rclone remotes mount to work please see this forum [thread](https://forum.rclone.org/t/failed-to-mount-fuse-fs-freebsd/7723/9). For me it was enough to run `sudo sysctl vfs.usermount=1`* 169 170### OpenBSD 1711. Install dependencies `sudo pkg_add git cmake qt5` 1722. Clone source code from this repo `git clone https://github.com/kapitainsky/RcloneBrowser.git` 1733. Go to source folder `cd RcloneBrowser` 1744. Create new build folder - `mkdir build && cd build` 1755. Run `cmake .. -DCMAKE_PREFIX_PATH:PATH=/usr/local/lib/qt5/cmake` from build folder to create makefile 1766. Run `make` from build folder to create binary 1777. Install `sudo make install` 178 179*Note: rclone for openBSD does not support `mount` hence this feature is disabled in Rclone Browser. cgofuse guys did not manage to implement it: [#18][billziss-gh_cgofuse_i18]* 180 181### NetBSD 1821. Install dependencies `sudo pkgin install git cmake qt5-qtdeclarative` 1832. Clone source code from this repo `git clone https://github.com/kapitainsky/RcloneBrowser.git` 1843. Go to source folder `cd RcloneBrowser` 1854. Create new build folder - `mkdir build && cd build` 1865. Run `cmake .. -DCMAKE_PREFIX_PATH:PATH=/usr/pkg/qt5` from build folder to create makefile 1876. Run `make` from build folder to create binary 1887. Install `sudo make install` 189 190*Note: rclone for NetBSD does not support `mount` hence this feature is disabled in Rclone Browser. cgofuse guys did not manage to implement it: [#18][billziss-gh_cgofuse_i18]* 191 192### macOS 1931. If you don't have [Homebrew](https://brew.sh/) yet install it `/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"` 1942. You might be asked to install xcode command line tools - do it. This is actuall macOS SDK, headers, and build tools. You don't need full xcode IDE. 1953. Install dependencies `brew install git cmake rclone qt5` 1964. Clone source code from this repo `git clone https://github.com/kapitainsky/RcloneBrowser.git` 1975. Go to source folder `cd RcloneBrowser` 1986. Create new build folder - `mkdir build && cd build` 1997. Run `cmake .. -DCMAKE_PREFIX_PATH:PATH=/usr/local/opt/qt` from build folder to create makefile 2008. Run `make` from build folder to create binary 2019. Go to yet another newly created build folder `cd build`. Your binary should be here 20210. Package your binary with Qt libraries to create self contained application `/usr/local/opt/qt/bin/macdeployqt rclone-browser.app -executable="rclone-browser.app/Contents/MacOS/rclone-browser" -qmldir=../src/`. Without this step binary won't work without Qt installed 203 204### Windows 2051. Get [Visual Studio 2019][8] - you need "Desktop development with C++" module only 2062. Install [CMake][9] 2073. Install latest Qt v5 (64-bit) from [Qt website][10]. You only need "Qt 5.13.2 Prebuilt Components for MSVC 2017 64-bit" (MSVC 2017 64-bit). Later steps assume you install it in c:\Qt 2084. Get rclone-browser source code. You either need to install git and clone it or download zip file from [releases][3] 2095. Go to source folder `cd RcloneBrowser` 2106. From cmd create new build folder - `mkdir build` and then `cd build` 2117. run `cmake -G "Visual Studio 16 2019" -A x64 -DCMAKE_CONFIGURATION_TYPES="Release" -DCMAKE_PREFIX_PATH=c:\Qt\5.13.2\msvc2017_64 .. && cmake --build . --config Release` 2128. run `c:\Qt\5.13.2\msvc2017_64\bin\windeployqt.exe --no-translations --no-angle --no-compiler-runtime --no-svg ".\build\Release\RcloneBrowser.exe"` 2139. build\Release folder contains now RcloneBrowser.exe binary and all other files required to run it 21410. If your system does not have required MSVC runtime you can install one from Microsoft [website](https://support.microsoft.com/en-gb/help/2977003/the-latest-supported-visual-c-downloads). 215 216Portable vs standard mode 217----------------------- 218 219In standard operations mode all configurations files are stored in the following locations: 220 221* macOS: 222 * preferences: ~/Library/Preferences/com.rclone-browser.rclone-browser.plist 223 * tasks file: ~/Library/Application Support/rclone-browser/rclone-browser/tasks.bin 224 * lock file: in $TMPDIR assigned by OS 225 226* Linux/BSD: 227 * preferences: ~/.config/rclone-browser/rclone-browser.conf 228 * tasks file: ~/.local/share/rclone-browser/rclone-browser/tasks.bin 229 * lock file: in $TMPDIR or /tmp if $TMPDIR is not defined 230 231* Windows: 232 * preferences: in registry Computer\HKEY_CURRENT_USER\Software\rclone-browser\rclone-browser 233 * tasks file: %HOMEPATH%\AppData\Local\rclone-browser\rclone-browser\tasks.bin 234 * lock file: %HOMEPATH%\AppData\Local\Temp\ 235 236Starting with version 1.7.0 of Rclone Browser portable mode is supported on all operating systems. To enable it you have to create .ini file (for Windows and macOS) next to executable with same name - e.g. if application name is `RcloneBrowser.exe` or `RcloneBrowser.app` create `RcloneBrowser.ini`. For Linux create a directory (not a file) with the same name as the AppImage plus the ".config" extension in the same directory as the AppImage file - e.g. if application name is `rclone-browser.AppImage` create folder `rclone-browser.AppImage.config` next to it. This is solution supported by [AppImage specification](https://docs.appimage.org/user-guide/portable-mode.html). 237 238In portable mode all configuration files will be stored in the same folder as application (in .config folder on Linux) and rclone and rclone.conf path can be relative to executable - so if in preferences in `rclone location` you put `rclone.exe` browser with look for it in folder where application resides. It means that you can put all required stuff including rclone binary itself and its config on e.g. memory stick and everything will be stored there. 239 240History 241-------- 242I have been using rclone-browser for long time and being annoyed by small not working bits and pieces I decided for DYI approach and this is how this repo was created. Original mmozeiko’s [repository](https://github.com/mmozeiko/RcloneBrowser) was abandoned and in the meantime rclone changed few things breaking rclone-browser functionality. 243 244I looked around but could not find anything fully working. Some github users made progress in fixing and adding stuff so I built upon it. 245 246I used DinCahill's [fork](https://github.com/DinCahill/RcloneBrowser) as a base for my version. 247 248I fixed whatever I found not working and added various tweaks enhancing functionality. I recompiled and repackaged everything using latest Qt (5.13.1) and latest platforms' compilers. This on its own fixed some issues and added new features like support for dark mode in macOS. Then followed with more fixes and more features. Rclone Browser was great again:) and is getting better. 249 250Code signing certificates donations 251--------------------------- 252 253If you would like to donate towards code signing keys please feel free to [do it](https://www.paypal.me/kapitainsky). If I don't raise required $500 I will give all money to some charity. Please see my note regarding it at the end of [How to get it](https://github.com/kapitainsky/RcloneBrowser#how-to-get-it) section. I will keep all updated with amount raised. 254 255Raised so far: 6.4 USD (1.3% of the required target) 256 257[1]: https://travis-ci.org/kapitainsky/RcloneBrowser 258[2]: https://ci.appveyor.com/project/kapitainsky/RcloneBrowser 259[3]: https://github.com/kapitainsky/RcloneBrowser/releases 260[4]: https://github.com/kapitainsky/RcloneBrowser/releases/latest 261[5]: https://github.com/kapitainsky/RcloneBrowser/blob/master/LICENSE 262[6]: https://www.videolan.org 263[7]: https://aur.archlinux.org/packages/rclone-browser 264[8]: https://docs.microsoft.com/en-us/visualstudio/releases/2019/release-notes 265[9]: http://www.cmake.org/ 266[10]: https://www.qt.io/download-open-source/ 267[img1]: https://api.travis-ci.org/kapitainsky/RcloneBrowser.svg?branch=master 268[img2]: https://ci.appveyor.com/api/projects/status/cclx7jc48t4u4x9u?svg=true 269[img3]: https://img.shields.io/github/downloads/kapitainsky/RcloneBrowser/total.svg?maxAge=3600 270[img4]: https://img.shields.io/github/release/kapitainsky/RcloneBrowser.svg?maxAge=3600 271[img5]: https://img.shields.io/github/license/kapitainsky/RcloneBrowser.svg?maxAge=3600 272[billziss-gh_cgofuse_i18]: https://github.com/billziss-gh/cgofuse/issues/18 273
){kind=link}
