Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Botspot/cloudbuddy
CloudBuddy is the ultimate wizard for cloud storage. It uses rclone to connect to your cloud drives, download from them, upload to them, mount them to your file manager, and more. In addition, CloudBuddy features an interactive file browser to easily generate shareable links and to perform various server-side operations.
https://github.com/Botspot/cloudbuddy
cloud cloud-storage dropbox google-cloud google-drive onedrive raspberry-pi raspberry-pi-4 rclone rclone-gui
Last synced: 4 days ago
JSON representation
CloudBuddy is the ultimate wizard for cloud storage. It uses rclone to connect to your cloud drives, download from them, upload to them, mount them to your file manager, and more. In addition, CloudBuddy features an interactive file browser to easily generate shareable links and to perform various server-side operations.
- Host: GitHub
- URL: https://github.com/Botspot/cloudbuddy
- Owner: Botspot
- Created: 2021-07-29T01:33:42.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2024-03-24T01:50:27.000Z (4 months ago)
- Last Synced: 2024-03-24T02:36:21.826Z (4 months ago)
- Topics: cloud, cloud-storage, dropbox, google-cloud, google-drive, onedrive, raspberry-pi, raspberry-pi-4, rclone, rclone-gui
- Language: Shell
- Homepage:
- Size: 340 KB
- Stars: 63
- Watchers: 8
- Forks: 9
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Lists
- awesome-stars - Botspot/cloudbuddy - CloudBuddy is the ultimate wizard for cloud storage. It uses rclone to connect to your cloud drives, download from them, upload to them, mount them to your file manager, and more. In addition, CloudBu (Shell)
README
# CloudBuddy
Bash-based GUI client for [`rclone`](https://rclone.org/). This was written by Botspot on 7/29/2021.
## Installation:
[](https://github.com/Botspot/pi-apps)
### Or, to download manually:
```
git clone https://github.com/Botspot/cloudbuddy
```
CloudBuddy is portable and can be executed from anywhere on your filesystem. For simplicity, this README will assume CloudBuddy is located in your `$HOME` directory.
## First run:
```
~/cloudbuddy/main.sh
```
When running for the first time, CloudBuddy will:
- Check and install **dependencies**: `yad`, `xclip`, `rclone`. Note: If `rclone` is already installed with **`apt`**, CloudBuddy will overwrite it with the latest version of [`rclone` from source](https://rclone.org/downloads/).
- Add a **Main menu launcher**. (`~/.local/share/applications/cloudbuddy.desktop`) This launcher is located under the **Internet** category.
- Make sure the "**`fuse`**" kernel module has been loaded so that `rclone` can mount drives. If fuse is not loaded, CloudBuddy will attempt to load it by running `sudo modprobe fuse`. If that fails, CloudBuddy's mounting capabilities will be disabled and hidden.
- **Check for updates**. If the last local commit and the latest online commit do not match, CloudBuddy will run `git pull` and refresh the script if it was modified. Note: If you make a fork of this repository, you should change the github URL in the script to point to your repository. To disable update-checking, create a file at: `~/cloudbuddy/no-update`.
## Usage
Note: CloudBuddy is intended to be **self-explanatory**. Everything should proceed in a logical fashon and nearly all users will have no problem using this program.
But for those few users who wish to get acquainted with CloudBuddy before they try it out, **here you go.**
## Connecting to a new cloud drive
This automates the [`rclone config`](https://rclone.org/commands/rclone_config/) process. Feel free to manually run `rclone config` for more options and a wider selection of cloud storage providers.
1. In the main window, click this button:
2. Choose a name for the new cloud drive, and select which type of drive it is.
3. Within seconds, a web browser will appear for authorization.
4. That's it!
## Disconnecting from a cloud drive
1. In the main window, click this button:
2. Choose a cloud drive to sign out of.
3. That's it! First, this uses [`rclone config disconnect`](https://rclone.org/commands/rclone_config_disconnect/) to ask the cloud to revoke rclone's API key, then deletes the cloud drive from `rclone`'s config file using [`rclone config delete`](https://rclone.org/commands/rclone_config_delete/).
## Mounting a drive
This uses [rclone's `mount` command](https://rclone.org/commands/rclone_mount/) to view your cloud drive as if it was an external data disk.
1. In the main window, click this button:
2. Select a drive to continue.
3. Choose an empty directory to mount the cloud drive to.
4. Wait for it...
5. Done!
## Unmounting a drive
1. In the main window, click this button:
2. Choose a drive to be unmounted.
3. Done!
## Browsing a drive
1. In the main window, click this button:
2. Select a drive to continue.
3. This is CloudBuddy's built-in file browser. It exclusively uses rclone commands for navigation and all operations are performed server-side.
The file browser is capable of:
- **Uploading** files or folders with this handy drag-n-drop window:
- **Downloading** the selected file(s) or folder(s) from the list to $HOME/Downloads. This takes advantage of [`rclone copy`](https://rclone.org/commands/rclone_copy/). Just look at that pretty terminal output!
- **Moving** or **Renaming** an item. This uses [the `rclone moveto` command](https://rclone.org/commands/rclone_moveto/) - it makes an API call to the cloud drive to perform the operation so no large downloads or uploads have to occur.
- **Deleting** the selected file(s) or folder(s) from the cloud drive. This uses [`rclone purge`](https://rclone.org/commands/rclone_purge/) or [`rclone deletefile`](https://rclone.org/commands/rclone_deletefile/) commands. Keep in mind that most cloud drives will keep deleted items in a recovery folder for a while.
- **Creating a publically sharable link** to the selected file or folder.
Notice the above **Copy** button. Because it uses `xclip` to copy the URL, CloudBuddy treats `xclip` as a required dependency.
## Web Interface
This simple button runs [rclone's built-in browser interface](https://rclone.org/gui/).
1. In the main window, click this button:
2. A web browser should open with rclone's HTML-based interface.
Fun fact: I (Botspot, the maker of CloudBuddy) was not aware rclone had this feature until *after* CloudBuddy was mostly complete.
And with that, the GUI usage tutorial comes to an end. If CloudBuddy was designed correctly, you didn't have to read this to use CloudBuddy.
## Command-line options
CloudBuddy is run by a single bash ***megascript***. It's not that long a script though, so why do I call it called a *mega*script?
Because CloudBuddy's `main.sh` script is actually **many bash scripts in one**.
When you launch CloudBuddy, it will start at the top of the script, run [a little preliminary stuff](https://github.com/Botspot/cloudbuddy#first-run) like update-checking, then ***skip*** nearly all the way to the end of the script and launch the main choice window. When you click a button, *that window will run another background instance* of CloudBuddy's `main.sh` with a command-line flag to preserve which button you clicked.
This approach has its downsides, but it is necessary for the main window to have a button layout of **3-by-2**. Otherwise, all 6 buttons would be in one long row - which would look horrible and would prevent additional buttons from being added due to space constraints.
Did I mention that all CloudBuddy windows use **`yad`**? This dialog box utility is the most robust GTK dialog available for bash scripting, and is the basis of [Pi-Apps](https://github.com/Botspot/pi-apps), [Pi Power Tools](https://github.com/Botspot/Pi-Power-Tools), [YouTubuddy](https://github.com/Botspot/youtubuddy), [Update Buddy](https://github.com/Botspot/update-buddy), [The TwisterOS Patcher](https://github.com/Botspot/TwistUP), and [Windows Screensavers for RPi](https://github.com/Botspot/Screensavers). YAD is not perfect though, and its inability to display multiple rows of exit-code-type buttons is a major hindrance.
**Enough said. Command-line options for CloudBuddy are below.**
PRO TIP: if you run CloudBuddy in a terminal, it will dynamically generate a custom-tailored command to instantly reach the exact same place later. For example, if I was using the file browser and wanted to quickly reach a deep subdirectory later, this information would be very helpful:
#### Set up CloudBuddy and then exit
On every launch, CloudBuddy checks for dependencies and creates a menu launcher. To run this preliminary stuff and then exit immediately, use this command-line flag:
```
~/cloudbuddy/main.sh setup
```
#### Source CloudBuddy's functions and then exit
Necessary for when CloudBuddy is downloading or uploading something in a terminal and we want to reuse CloudBuddy's colorized-`echo` functions.
```
source ~/cloudbuddy/main.sh source
```
More functions may be added in the future, but at the time of writing this they are: `error`, `warning`, `echobright`, `echocommand`, `echoprogress`, `list_descendants`, `back`, `drivetype`, and `choosedrive`.
#### New drive
```
~/cloudbuddy/main.sh newdrive
```
Optionally, a drive name and drive type can be specified (in that order) on the command-line to skip launching the selection window.
#### Remove drive
```
~/cloudbuddy/main.sh removedrive
```
Optionally, a drive name can be specified on the command-line to skip launching the selection window.
#### Mount drive
```
~/cloudbuddy/main.sh mountdrive
```
Optionally, a drive name and mountpoint can be specified (in that order) on the command-line to skip launching the selection window.
#### Unmount drive
```
~/cloudbuddy/main.sh unmountdrive
```
Optionally, a drive name, OR a mountpoint can be specified on the command-line to skip launching the selection window.
#### Browse drive
```
~/cloudbuddy/main.sh browsedrive
```
Optionally, a drive can be specified on the command-line to skip launching the selection window. Additionally, you can specify a subfolder to begin in, like this:
```
~/cloudbuddy/main.sh browsedrive "My Google Drive:Attachments/old stuff"
```
Additionally, a simpler, faster file browser can be launched if the `fastmode` variable is set to **`1`**, like this:
```
fastmode=1 ~/cloudbuddy/main.sh browsedrive
```
#### Web Interface
```
~/cloudbuddy/main.sh webinterface
```