Kylo Kylo
Bookmark

How to use Seedbucket

Posted September 21st, 2017    26939   3   getting started how to seedbucket rclone encryption

file

Introduction

Seedbucket was developed in-house by Seedboxes.cc, in an effort to be an one-stop modern alternative for your day to day seedbox management. It has an integrated state of the art File Manager and an integrated Torrent Client Web UI.

Our plan is to keep improving seedbucket very often and keep adding features in order to make it as user friendly and useful as possible!

Installation

You can install Seedbucket with ONE click from “Installable Apps” in your client area. The application will be pre-configured and ready to be used as soon as installation completes.

file

Afterwards, just click the "Go to Application" button and a new window will open with your seedbucket.

file

Dashboards

Dashboards is still under heavy development but the idea behind it is that you will be able to setup a custom layout with a combination of individual components. For example, you will be able to create a split layout which on the left side will have a file manager with your local files and on the right side your torrent client. However, this is not fully ready yet at the moment which means you are currently limited to connect an external storage drive and manage its files.

We currently support Google Drive, Dropbox , OneDrive , FTP and SFTP.

Your Seedbucket comes pre-installed with two dashboards; Local Files, for managing your local files and Torrent Client which by default is pre-configured to connect to your seedbox default torrent client.

Connecting an external storage drive

The process is very simple. You basically need to create a new dashboard that you will connect with an external storage drive (e.g. Google Drive) and then you will be able to access that storage from within a Dashboard.

1) Click on "New" on the left main sidebar

file

2) If this is the first time you do this then you will need to add a storage drive in order to proceed

file

Google Drive

You will be prompted to choose a storage drive type. For example, if you want to choose Google Drive

file

You will be re-directed to the Google authorization page where you will need to authorize Seedbucket in order to be able to access your files

file

Once you authorize the drive, a modal will appear asking if you want to add the drive using whole drive encryption or not (default).

One Drive

Similarly, if you want to use One Drive

file

Depending on your email's Microsoft domain (e.g. @live.com, @outlook.com, @hotmail.com etc), you might be re-directed to the Microsoft authorization page which you will need to authorize Seedbucket in order to be able to access your files

file

Dropbox

Adding Dropbox to your file manager is also an option

file

The process of allowing seedbucket to access your Dropbox is similar to those above. Alternatively, if you have enabled a third-app authenticator (e.g. Authy) for your Dropbox account, you need to provide the generated code

file

Once you authorize the drive, a modal will appear asking if you want to add the drive using whole drive encryption or not (default).

FTP

Before you establish an FTP or SFTP connection you will have to fill the settings form accordingly

For FTP:

file

For example, connecting to your seedbox:

  • Host: {username}.cloud.seedboxes.cc
  • Port: You can find your port number under FTP Access in your client area
  • Secure (Optional): To enable TLS, for encrypted transmission
  • Home Path (Optional): Personalize your home path. e.g. /files/downloads

Using authentication:

  • Username: Your FTP username (same as your seedbox username)
  • Password: Your FTP password (same as your seedbox password)

Choosing file size format

  • Binary: Choose the filesize shown as 1KB = 1024 bytes
  • Decimal: Choose the filesize shown as 1KB = 1000 bytes

Once you install the drive, a modal will appear asking if you want to add the drive using whole drive encryption or not (default).

SFTP

For an SFTP connection, the form is a bit different

For SFTP:

file

Connecting to your seedbox:

  • Host: {username}.cloud.seedboxes.cc
  • Port: You can find your port number under SFTP/SSH access in your client area
  • Home Path: Like FTP, choose to personalize your home path. e.g. /home/user/files

If you have generated a private key and want to use it:

  • Private Key (Optional): Copy and paste your private key from the key pair that you generated
  • Passphrase (Optional): If your key carries a passphrase, paste it here

NOTE: The private key MUST be of RSA/ECSDA type with PEM compatibility, which means that is has to be created by issuing the command:
ssh-keygen -t rsa -m PEM - it can have whatever length you want, but the default (2048) is more than fine.
Also, don't forget to do all of the following:
1. At your seedbox, create the necessary ~/.ssh folder if it doesn't exist
2. Store the public key (e.g. new_id_rsa.pub) inside that directory
3. Give the following command to authorize the pair; cat new_id_rsa.pub >> ~/.ssh/authorized_keys

Choosing file size format

  • Binary: Choose the filesize shown as 1KB = 1024 bytes
  • Decimal: Choose the filesize shown as 1KB = 1000 bytes

Once you install the drive, a modal will appear asking if you want to add the drive using whole drive encryption or not (default).

Use whole drive encryption

After connecting an external storage, you have a choice of adding that storage using whole drive encryption. Currently, encryption works on Google Drive, Dropbox and on any FTP / SFTP drive.
file

NOTE: Before you add the whole drive with encryption, please proceed here to find important information regarding the encryption flow and how to complete the process

Adding your connected drives to your dashboard

3) After you finish adding your external storage drive(s), you will be re-directed back to your Seedbucket. The new storage drive will be added which you will be able to choose and proceed with creating your new dashboard when you click "Next"

file

4) If you want all the folders to be shown when you add the drive, just hit the Select Drive.
file

Alternatively, if you want only a certain folder (and its subfolders) to be shown, navigate to that folder so you can set it as a home folder and click "Select Folder" . Only those files and folders under that home folder will be shown at your dashboard.

file

5) Fill in your desired name for your new dashboard, click "Add" and you are done!

file

6) Your new dashboard will appear on the left main sidebar and it will automatically open for you the first time you add it

file

If you need to connect more storage drives, then repeat the above steps! And if you got several email addressess from the same provider, each with its own different cloud storage, you can add them all !

file

Profile

You can easily access your profile from the upper right corner by clicking on your username and then "Settings".

Dashboards Manager

From here you can manage all your dashboards.

file

Just hover over the desired dashboard you want to manage and all available actions will appear which you can click and follow the instructions.

NOTE: By deleting a dashboard, you remove it from your file manager but the dashboard remains in your "Drives" manager in case you need it again in the future.

Drives Manager

From here you can manage all your connected storage drives and also check their available disk space.
All available actions appear at the same row with the drive. Please keep in mind that not all drives have the same actions. There are some exceptions, like the Local File System drive, which comes pre-installed, and can not be deleted.
You will also notice an action for the Local File System drive that is not available to the other drives, Index files which will force re-index all your files in your seedbox.
FTP / SFTP drives can be edited and encryption can be set to all drives, other than Local File System and Onedrive, that don't have encryption set already.

If you have set an encryption method, either for the whole drive or just for a folder / some folders, the row of those drives will appear with a different background color and with a lock icon at their top right corner, indicating that encryption has been set.

file

In addition, you can see the Encryption details for the drives that encryption has been already set.

For drives that are encrypted as a whole:
file

For specific folders that are encrypted, the modal changes to this view:
file

NOTE: Please proceed here to find important information regarding encryption

NOTE #2: By deleting a drive from the manager, you remove it completely from your seedbucket. Your files will of course remain intact. In case you need it again in the future, you have to follow the same procedure of adding the storage and using it.

Settings

From the settings page, you will be able to edit basic things like your email and password.

file

Current Password is always required when editing settings.

Apps

From this tab, you can easily install all available apps. This, however, is a work in progress, currently you can only install your Plex application. The old way of 1-click installable apps from your client area will be soon obsolete.
For a thorough guide regarding all the steps necessary for the Plex installation, either with Google integration or not (now updated with encryption too!), please check our guide here .

file

Preferences

From here you can choose some default preferences that will be used globally. More preferences will be added in the near future.

file

UI Preferences

1) Default Theme:
Select your default site theme Select how the site will appear, either with a light or a dark theme

2) Torrent ratio color
Enable torrent ratio color depending on your ratio percentage

Search preferences

1) Search only the current dashboard
When this is enabled, then the search is done only for the dashboard that is active, which means that results will be shown in a modal for that particular dashboard instead of global search.
NOTE: When searching in the torrent dashboard, a list will appear at the torrent dashboard with the results instead of a modal

2) Torrent client dashboard only - Show results in list instead of global search
When this is enabled and the torrent dashboard is active, then the search results are filtered in a list inside the dashboard, instead of showing them in a modal

Star folders

You can also add starred folders for quick access in move/copy to actions or delete current starred folders.
Adding starred folders can also be done when you are browsing your file manager - check info below for a thorough procedure on how creating and using predefined (starred) folders.

File Manager

Seedbucket comes with a complete file manager that allows you to easily manage your local and remote files and perform operations on them.

By right clicking on either a file or folder, a menu will appear that will allow you to perform various actions. A few of them are:

  • Standard file operations (create folder/move/delete/rename)
  • Compress/Extract archives (rar, zip, 7z, tar, tar.gz and bzip2)
  • Create torrent
  • Add torrent
  • Show media info
  • Share a file with 3rd parties via share link which expires after a configurable period
  • Generate screenshots from video files
  • Copy files and folders between cloud storages and within the same storage
  • Mark a folder as starred folder for quick and easy access when you move/copy items to it
  • Set encryption to that folder

Move

You can move files and/or folders inside the same cloud storage and to your folder of choice. Select the items and right-click for the modal to appear, then choose "Move" action.

Compress/Extract archives

You can easily extract or create archives with a compression type and comporession quality of your choosing. Simply right click on the file or folder you wish to compress, select the output path and the compression settings and just click "Create".

file

If you wish to extract an archive, simple right click on it, select "Extract".

file

Create torrents

Creating torrents has never been easier! Simple select the files you wish to add to your .torrent, right click on them, "Create Torrent", enter your torrent settings and click "Create".

file

Add torrent

Torrent files with the appropriate .torrent extension, can be added in your torrent client in an instant.

file

The torrent will be added to your torrent list to your connected client.

file

Share files

You can easily share files (not folders) by simply selecting a file, right clicking on it and then "Share Link".

file

A share link will automatically be generated for you which you can either destroy or copy any time in order to provide it to whomever you want to download the file. Please do make sure that you do not post those share links in public forums or chat rooms or else anyone will be able to download the file.

file

You can choose the expiration time of the link (minutes, hours, days, weeks, months) and click "Share".

And if you want to resend the same shared link, you can always come back later anytime but within the time limit you have set for the link's expiration time. Just head to your seedbucket, find the file that you have already shared and either click the "chain" icon which is at the "SHARED" column or right click the file and choose "Share link", just like you did when you created the shareable link. The modal will appear and you can now copy again the same link.

file

NOTE: If you want to share a folder, you can create a compressed file of this folder and share that file. The user that will download it must uncompress it afterwards.

Resumable uploads

Tired of having to re-upload a file due to a network error? Then try our resumable uploads from within your file manager by simply clicking on the "Upload" button on the upper right corner. Drop the files you wish to upload and in case of a network error, then simply re-upload them and after they are quickly checked, they will continue from where they left off!

file

NOTE: Resume capability currently applies only for your local files and not the cloud drives although we do plan to support it in the near future.

Starred folders

Wouldn't you wish there was a quick way to choose folders that you frequently move/copy to, without having to navigate inside them again and again? You can now set predefined folders of your choice, either at your local or cloud-based storage, and even uniquely name them however you want! This will not rename the original folder, it's just an easy reference name used by you.

file

There are several ways to create predefined folders;

1) Just right-click selected folder and choose "Star folder"

file

2) You can hover the mouse pointer at the folder and click the outlied "star" icon to the right of the folder's name. The star gets filled and that folder instantly becomes a starred folder! Nice 'n' easy, especially if you don't care about giving it a reference name

file

3) Similarly, you can click the outlied star icon at the breadcrumbs section

file

4) Finally, you can also add starred folders from the Preference settings of your profile

file

Bear in mind, the names you give at your predefined folders must be unique - you can't have the same reference name for different starred folders. If you proceed giving the same reference name, there will be a modal at the top right corner informing you that an arithmetic prefix was added next to it so you distinguish it from your already referenced folder.

file

You can delete the reference name from a starred folder, just pick any option from above and reverse your actions. This will NOT delete the folder, just the reference name of it.

Copying files and folders

Your file manager provides you the ability to easily copy files and folders within the same storage drive or between them. For example you can copy a file from your seedbox to your Google Drive or from your Google Drive to your Dropbox; You can even copy from an encrypted source to an unencrypted destination and vice versa - any combination is possible.

In order to copy a file or a folder simply select one, or multiple files/folders you wish to copy, right click and "Copy To".

1) Right click on the item(s) you want to copy and click "Copy To". A modal will appear which will allow you to choose the destination storage drive and folder. All your connected storage drives should appear in the dropdown list. As a quick option, if you have already set starred folders, you can directly copy the items to that starred folder. Also, if you have set whole drive encryption, a lock icon will appear at its right side.

file

2) Select the target drive and folder and click "Copy"

file

Note: If a folder is encrypted, a lock icon will be shown inside the folder icon, indicating that encryption has been set to that folder. This means that the items that will be copied to that encrypted folder will also be encrypted too.

3) Your transfer will begin in the background and it's status will be shown at the bottom left corner

file

You can stop the transfer any time by clicking on the trash icon next to it.

Encryption

We have implemented rclone utility for encrypting folders -or even your whole drives! Currently, encryption works on Google Drive, Dropbox and on any FTP / SFTP drive.
Encrypting a folder (or a whole drive) means that new content that will be copied or moved to that folder will also be encrypted. However, current files and folders, prior to the folder/drive encryption, will remain unencrypted. So it is possible to have mixed content if you like.

Folder encryption

There are two ways you can create a new encrypted folder:

a) Navigate to the path you wish to create that folder to, click at the top right button New and select Encrypted folder
file

b) Choose an (unencrypted) folder you have already created, right click and at the context menu, choose Encrypt folder
file

Both ways will open up the Encryption settings modal, where you can select how to complete the encryption process.

There are three routes you can follow from here:
file

NOTE: CHECK "Important! Save your encryptions keys!" SECTION BELOW REGARDING ENCRYPTION KEYS BEFORE FINALISING THE ENCRYPTED FOLDER CREATION

This is the easiest and fastest way to set up the encryption. Both files and folder names that will be copied or moved inside your encrypted folder will also be encrypted. Encryption key (password1) and salt (password2) will be randomly generated for you. These will be the original (non-obfuscated) passwords. Don't forget to write down those keys and keep them safe somewhere!

file

No pre-existing encryption - set it up manually

This option offers full customization. You can either use standard encryption, simple obfuscate or add a ".bin" extension to your files. Furthermore, you can select whether you want to encrypt the folder names as well
file

Also, you can use either randomly generated encryption keys, or choose your own encryption keys. Encryption key (password1) and salt (password2) will be your original (non-obfuscated) passwords.
Whatever you choose, don't forget to write down those keys and keep them safe somewhere!
file

Folder is already encrypted

In case the folder has been encrypted in the past and you wish to continue using it as an encrypted folder but erased the encryption settings in between, you can provide the encryption options you used as well as the obfuscated (non-original) keys you used in order to continue using it.
You have to choose the same encryption settings as the ones you chose when you created it in the past, just inputting the obfuscated keys is not enough - you have to do both!
After you confirm password1 and password2, the folder will gain the lock icon

file

NOTE: Don't use (new) encryption settings for an (old) encrypted folder, as this will NOT allow you to see your current (old) files/folders as decrypted.

Whole drive encryption

To use whole drive encryption select the second choice when connecting the external storage device
file

The encryption flow is exactly the same as creating a new encrypted folder, please see the above section

Important! Save your encryptions keys!

WRITE DOWN AND KEEP SAFE BOTH ORIGINAL (NON-OBFUSCATED) AND OBFUSCATED PASSWORDS (KEY/SALT) BECAUSE IF YOU LOSE THEM, YOU WILL BE UNABLE IN THE FUTURE TO ACCESS YOUR ENCRYPTED DATA !!

The original (non-obfuscated) keys are only shown during the creation of the encrypted folder and before its finalization. If you complete the process, there is no way you can find what those keys were. So you must be very cautious if you choose to randomly generate the passwords.

The obfuscated keys can be found after the creation of the encrypted folder. Just either right click the encrypted folder and choose Encryption keys or go to your Settings -> Drives and click the Encryption Settings of the drive you have the encrypted folder inside. From there, you can also save the rclone configuration (that shows the encryption settings and obfuscated key and salt), just choose the corresponding Show Keys button and Rclone Settings at the new modal
file
file
file

Whatever route you decide to take regarding folder encryption, you can easily distinguish encrypted folders from unencrypted ones
file

NOTE: Your files will be a bit larger in size when placed inside an encrypted folder. This is expected as the rclone util adds an overhead to each file in order to encrypt it. When you move or copy that file to an unencrypted folder, decryption will automatically initiate and the file will return to its original size.

Torrent Client

A common user interface for your rTorrent and Deluge connections is also integrated in Seedbucket. From here you will be able to control any local or remote torrent clients you might have. At the moment the Seedbucket torrent client is basic but new features are being added every day.

Please note that some menu options might not exist in both rTorrent and Deluge connections and in some cases an action menu might not exist at all (e.g. in Torrent Files tab for Deluge).

If you right click on a torrent (after a connection is established and your list loads) you will see the following action menu:

file

  • Start: Will start the selected torrent(s)
  • Stop: Will stop the selected torrent(s)
  • Remove: Will remove the selected torrent(s), with the option to remove their data from disk as well
  • Force Recheck: Will force recheck the selected torrent(s)
  • Update Trackers: Will force announce to the associated trackers for the selected torrent(s)
  • Change Path...: Will move the selected torrent(s) to the newly selected directory. If your torrent(s) was already seeding then it will be resumed after the move completes
  • Edit Torrent: Will bring up the Edit Torrent modal in order to edit the torrent trackers, comment and private flag
  • Get torrent file: If the torrent client connection is your local seedbox connection it will download the torrent file
  • Priority: Will change the priority for the selected torrent(s)
  • Add Label: Add or select a new label for the selected torrent(s)
  • Speed Limit: Adjust torrent's speed limit by slider or input (NOTE: this option exists only in Deluge for now)
  • Go To Files: Will take you to the folder where the torrent files are
  • Torrent Details:: Will bring up the torrent details drawer

Edit Torrent

If you click Edit Torrent from the torrent menu actions then you will see the following modal:

file

Just change whatever you need, click Edit and your torrent will be updated with the new values!

Speed Limit

If you click Speed Limit from the torrent menu actions on Deluge you will see the following submenu
where you can adjust the torrent's speed limit by dragging the slider or by typing the desired value.

NOTE: Your changes will be applied when you close the context menu .

file

In the top of your torrent list you will find the search input from where you can filter your torrent list and see immediately all results.

file

Torrent Details

General

Useful generic information about the selected torrent.

file

Files

The torrent file tree with useful information, such as the current progress of the file. In addition, for each file there is an action menu (just right click on a file or click the three dots in the last column if you are in mobile view).

file

NOTE: if you are connecting to a Deluge daemon then there is no action menu.

Trackers

A list of all associated trackers with this torrent.

file

If you notice on the screenshot above, there is a small lock icon which indicates that the torrent tracker is private.

Peers

A list of connected peers while leeching/seeding.

file

Torrent Client Settings

To modify your torrent client settings, navigate to Torrent Client Settings by clicking the gears icon located on the main toolbar.

file

As you will see, your torrent client settings have their default values. Of course, feel free to modify them any time.

file

In torrent client settings you can:

  • Set your default download path
  • Enable watch folder and set your watchfolder's path
  • Enable option for autostart torrents after they are imported
  • Enable move completed files and set the path where your files will be moved after completion
  • Change your torrent client's global upload and download limits with the slider or by typing
  • Enable DHT Network
  • Enable Peer Exchange

Connection Manager

To create a connection, navigate to Connection Manager by clicking the plug icon located on the main toolbar.

file

As you will see, your seedbox torrent client settings have already been configured for you. Of course, feel free to add more if you wish any time.

file

From the connection manager you can:

  • Connect/disconnect to a torrent daemon
  • Create a new rTorrent or Deluge connection
  • Edit a connection
  • Delete a connection
  • Choose a new default connection

NOTE: Transmission is not currently supported.

Uploading

You can easily upload torrents to your torrent client by simply clicking the plus icon from the main toolbar.

file

The following modal will appear which will allows you to either upload .torrent files or you can add a torrent using a magnet url.

file

There are a few options you could use when uploading such as:

  • Start automatically: By default the torrent(s) will be started as soon as upload completes. Toggle off to add them in Paused state
  • Select new path: If you do not wish the default torrent client save path to be used, set your path here and will be used for all uploaded torrents
  • Label: Automatically add a new or existing label

Labels

Adding new labels to torrents is very easy.

Right click on your selected torrent and then click on the "Add Label..." menu. The menu itself is a text field, so once you click it a caret is going to start flashing and you can start typing. Once finished you can press Enter or click the "Add" on the right side. The label will appear on the left side of the torrent's name.

file

Existing labels will appear on the right side of the "Add Label..." when you hover it so you can quicly add them to your selected torrents. You can also remove labels from the selected torrents by selecting "None".

file

You can also modify the color of the label to the one you prefer.

file

Which will result to all the corresponding labels to change as well:

file

Bottom bar

In torrent client there is a bottom bar where there are various global controls and statistics.

file

These are:
* Your global download and upload speed
* an input where you can see and change your global upload and download speed limits
* your total uploaded and downloaded bytes
* torrent client's version as well as the seedbucket version by clicking on the info popup in the right end of the bottom bar

file

You can change speed limits just by clicking on the speed limit value you want(upload or download) and modify it by slider or by typing in the input that will appear.

file

User Feedback

Seedbucket was created for YOU so your feedback is very important for us. You can easily send us any bugs, suggestions or anything at all from within your seedbucket by simply clicking on the send icon on the bottom of the left main sidebar.

file

A modal will appear which you can write anything you want and even attach screenshots if it helps!

5 Comments

muhahaha
muhahaha

Thanks for this, great stuff!
Not to sound ungrateful but: 'When's the next major release? Waiting for copying of folder support in file management.'

chewchew
chewchew

Just started using this. It's been great so far. It's nice and fast, and works on every computer I own. One feature that would be great is a good bulk rename tool. And just some better tools for file management in general.

manipulas
manipulas

If i move my files to plex folder via seedbucket will they stop seeding?

fergusmcphail
fergusmcphail

Spent a few hours trying to wrap my head around this but can't. The more I read about it the less I understand. Still no closer to figuring out what it is for or how to use it so I may as well get rid of it. I tried.

Morgasm
Morgasm

Hey, I have kind of a stupid question.
What does the Watch folder do? Does it auto add torrents that get added to this folder?

Here's the info from above

In torrent client settings you can:

Set your default download path
> Enable watch folder and set your watchfolder's path
Enable option for autostart torrents after they are imported
Enable move completed files and set the path where your files will be moved after completion
Change your torrent client's global upload and download limits with the slider or by typing
Enable DHT Network
Enable Peer Exchange
Thanks for any help!