169 lines
6.5 KiB
Markdown
169 lines
6.5 KiB
Markdown
<img src=".github/rclone-mobile.png" alt="Rclone Mobile" width="100%">
|
||
|
||
<br />
|
||
<br />
|
||
|
||
<h1 align="center">
|
||
<a href="https://rcloneui.com">
|
||
<img src="./.github/banner.png" alt="Rclone UI" width="100%">
|
||
</a>
|
||
<br>
|
||
<a href="https://rcloneui.com">
|
||
The cross-platform GUI for Rclone
|
||
</a>
|
||
</h1>
|
||
|
||
<h3 align="center">
|
||
<strong>A light, transparent layer on top of <tt>rclone</tt> to manage your remotes & tasks in a more user-friendly way.</strong>
|
||
</h3>
|
||
|
||
<br />
|
||
|
||
<p align="center">
|
||
<a href="https://github.com/rclone-ui/rclone-ui/releases/latest">
|
||
<img alt="Latest Release" src="https://img.shields.io/github/actions/workflow/status/rclone-ui/rclone-ui/release.yml?style=for-the-badge" />
|
||
</a>
|
||
|
||
<a href="https://github.com/rclone-ui/rclone-ui?tab=readme-ov-file#downloads">
|
||
<img alt="Downloads" src="https://img.shields.io/badge/DOWNLOADS-blue?style=for-the-badge&label=Tap%20to%20see" />
|
||
</a>
|
||
|
||
<a href="https://tauri.app/?ref=rclone-ui">
|
||
<img alt="Tauri" src="https://img.shields.io/badge/Tauri-brown?style=for-the-badge&logo=rust&color=f85214" />
|
||
</a>
|
||
</p>
|
||
|
||
<p align="center">
|
||
<a href="https://github.com/rclone-ui/rclone-ui?tab=readme-ov-file#package-managers">
|
||
<img alt="Choco" src="https://img.shields.io/badge/Choco-42345f?style=for-the-badge&logo=chocolatey" />
|
||
</a>
|
||
|
||
<a href="https://github.com/rclone-ui/rclone-ui?tab=readme-ov-file#package-managers">
|
||
<img alt="Flathub" src="https://img.shields.io/badge/Flathub-000000?style=for-the-badge&logo=flathub" />
|
||
</a>
|
||
|
||
<a href="https://github.com/rclone-ui/rclone-ui?tab=readme-ov-file#package-managers">
|
||
<img alt="Homebrew" src="https://img.shields.io/badge/BREW-1f1d1a?style=for-the-badge&logo=homebrew" />
|
||
</a>
|
||
</p>
|
||
|
||
<p align="center">
|
||
<a href="https://github.com/rclone-ui/rclone-ui/stargazers">
|
||
<img alt="GitHub Repo stars" src="https://img.shields.io/github/stars/rclone-ui/rclone-ui" />
|
||
</a>
|
||
</p>
|
||
|
||
<br />
|
||
|
||
<a href="https://get.rcloneui.com/showcase">
|
||
<img src=".github/rclone-video.png" alt="The GUI for Rclone">
|
||
</a>
|
||
|
||
## Docker/Homelab/Server Usage
|
||
Control your server, homelab, or mom's PC with **the easiest solution to manage remote **`rclone`** instances.**
|
||
|
||
#### Docker Compose
|
||
```yaml
|
||
services:
|
||
rclone:
|
||
image: rclone/rclone
|
||
container_name: rclone
|
||
command: rcd --rc-addr=0.0.0.0:5572 --rc-no-auth
|
||
ports:
|
||
- 5572:5572
|
||
volumes:
|
||
- ./config:/config/rclone
|
||
- /path/to/data:/data
|
||
```
|
||
|
||
#### Docker CLI
|
||
```bash
|
||
docker run -d \
|
||
--name rclone \
|
||
-p 5572:5572 \
|
||
-v ./config:/config/rclone \
|
||
-v /path/to/data:/data \
|
||
rclone/rclone rcd --rc-addr=0.0.0.0:5572 --rc-no-auth
|
||
```
|
||
|
||
#### Without Docker
|
||
Just start the `rcd` daemon directly:
|
||
|
||
```bash
|
||
rclone rcd --rc-addr=0.0.0.0:5572 --rc-no-auth
|
||
```
|
||
|
||
#### Notes
|
||
- After starting up **`rclone`** using your preferred method, simply open Rclone UI and navigate to Settings > Hosts.
|
||
- Make sure to allow traffic to port **`5572`** in your firewall and/or reverse proxy (nginx/caddy/traefik).
|
||
- Rclone UI can connect to any RCD port, so you can customize the default **`5572`** port.
|
||
- Use **`--rc-user`** and **`--rc-pass`** instead of **`--rc-no-auth`** in production.
|
||
|
||
|
||
## Package Managers
|
||
- Flathub **`flatpak install com.rcloneui.RcloneUI`** or **[from the store](https://flathub.org/en/apps/com.rcloneui.RcloneUI)**
|
||
- Brew **`brew install --cask rclone-ui`**
|
||
- Scoop **`scoop bucket add extras`** & **`scoop install rclone-ui`**
|
||
- Chocolatey **`choco install rclone-ui`**
|
||
- WinGet **`winget install --id=RcloneUI.RcloneUI -e`**
|
||
- NPM **`npx rclone-ui`**
|
||
|
||
## Downloads
|
||
- **Windows** (**[Arm](https://get.rcloneui.com/win-arm)**, **[x64](https://get.rcloneui.com/win)**)
|
||
- **macOS** (**[Apple Silicon](https://get.rcloneui.com/mac)**, **[Intel](https://get.rcloneui.com/mac64)**)
|
||
- **Linux** (**[AppImage](https://get.rcloneui.com/linux)**, **[deb](https://get.rcloneui.com/linux-deb)**, **[rpm](https://get.rcloneui.com/linux-rpm)**)
|
||
- **Linux `Arm`** (**[AppImage](https://get.rcloneui.com/linux-arm)**, **[deb](https://get.rcloneui.com/linux-deb-arm)**, **[rpm](https://get.rcloneui.com/linux-rpm-arm)**)
|
||
|
||
## Roadmap
|
||
> Finalized items have been moved to the "Features" section.
|
||
### [Check out the V3 discussion!](https://github.com/rclone-ui/rclone-ui/issues/18)
|
||
|
||
## 1 Star = 1 Instant Coffee
|
||
<a href="https://www.star-history.com/#rclone-ui/rclone-ui&Timeline">
|
||
<picture>
|
||
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=rclone-ui/rclone-ui&type=Timeline&theme=dark" />
|
||
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=rclone-ui/rclone-ui&type=Timeline" />
|
||
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=rclone-ui/rclone-ui&type=Timeline" />
|
||
</picture>
|
||
</a>
|
||
|
||
## Contributing
|
||
Welcome, anon. We’ve been expecting you.
|
||
|
||
Here are some good problems to tackle:
|
||
- Fix an open [**Issue**](https://github.com/rclone-ui/rclone-ui/issues)
|
||
- Upgrade repository to Vite 7 & React 19
|
||
- Introduce React Compiler
|
||
- Move Cron logic to Rust
|
||
|
||
🎁 **Merged PRs receive a Lifetime License!**
|
||
|
||
<br />
|
||
|
||
<p align="center">
|
||
<a href="https://github.com/rclone-ui/rclone-ui/blob/main/README.md">
|
||
<img alt="English" src="https://img.shields.io/badge/ENGLISH-chartreuse?style=for-the-badge" />
|
||
</a>
|
||
<a href="https://github.com/rclone-ui/rclone-ui/blob/main/README_CHINESE.md">
|
||
<img alt="Chinese" src="https://img.shields.io/badge/CHINESE-gray?style=for-the-badge" />
|
||
</a>
|
||
<a href="https://github.com/rclone-ui/rclone-ui/blob/main/README_JAPANESE.md">
|
||
<img alt="Japanese" src="https://img.shields.io/badge/JAPANESE-gray?style=for-the-badge" />
|
||
</a>
|
||
<a href="https://github.com/rclone-ui/rclone-ui/blob/main/README_POLISH.md">
|
||
<img alt="Polish" src="https://img.shields.io/badge/POLISH-gray?style=for-the-badge" />
|
||
</a>
|
||
<a href="https://github.com/rclone-ui/rclone-ui/blob/main/README_GERMAN.md">
|
||
<img alt="German" src="https://img.shields.io/badge/GERMAN-gray?style=for-the-badge" />
|
||
</a>
|
||
<a href="https://github.com/rclone-ui/rclone-ui/blob/main/README_SPANISH.md">
|
||
<img alt="Spanish" src="https://img.shields.io/badge/SPANISH-gray?style=for-the-badge" />
|
||
</a>
|
||
<a href="https://github.com/rclone-ui/rclone-ui/blob/main/README_ROMANIAN.md">
|
||
<img alt="Romanian" src="https://img.shields.io/badge/ROMANIAN-gray?style=for-the-badge" />
|
||
</a>
|
||
<a href="https://github.com/rclone-ui/rclone-ui/blob/main/README_PIRATE.md">
|
||
<img alt="Pirate" src="https://img.shields.io/badge/PIRATE-gray?style=for-the-badge" />
|
||
</a>
|
||
</p>
|