SUpreme ^TM

<p align="center"> <img src="https://github.com/Kiran-Bose/supreme/blob/master/SUpreme_Logo.jpg"> </p>

SUpreme is a command line file manager written in shell script.

SUpreme supports file management operations on phone(android),usb drive,cloud storage and local drive(Tested for ubuntu 18.04).

Dependencies

<details> <summary>rclone</summary> Supreme(>v1.1.22) uses package 'rclone'(>=v1.42) for cloud storage operations. rclone will be downloaded and installed automatically.

Incase rclone fails to install.

• Get rclone here

</details> <details> <summary>jq</summary> jq is a lightweight and flexible command-line JSON processor. jq will be downloaded and installed automatically.

Incase jq fails to install.

• Get jq here

</details> <details> <summary>curl</summary> command line tool and library for transferring data with URLs. curl comes inbuilt in most of the Linux distros. If not curl will be downloaded and installed automatically.

Incase curl fails to install.

• Get curl here

</details>

Usage

Type 'supreme' and hit enter in the bash terminal. Follow the instructions

Functionality Overview

<details> <summary>(1)Manage Apps</summary>

----Open Apps                                  
----Configure App List

</details> <details> <summary>(2)Manage Files</summary>

                |----Select File(s)
                |----Select all
                |----Inverse selection
                |----Range selection
                |----Select root folder
                |----Navigate
                |----Search
                |----Quick access
                |----Make directory
                |----Make file
                |----back
                |----home
                                             
                                              |----Open
                                              |----Copy
                                              |----Move
                                              |----Delete
                                              |----Rename
                                              |----Send to Device
                                              |----Upload to Cloud
                                              |----Move to Cloud
                                              |----Properties
                                              |----Compress
                                              |----Extract
                                              |----Go Home

</details> <details> <summary>(3)Manage Phone</summary>

----Phone File Explorer           
----Sync
----Configure sync                          

</details> <details> <summary>(4)Manage USB</summary>

----USB File Explorer
----Format
----Sync
----Configure sync
----Create bootable USB

</details> <details> <summary>(5)Manage Cloud</summary>

----Cloud File Explorer
----Sync
----Configure sync
----Configure Cloud

</details> <details> <summary>(6)Manage Custom Scripts</summary>

----Add Script
----Remove Script(s)
----Modify Script
----Execute Script
----Run Commands

</details> <details> <summary>(p)Preferences</summary>

----Configure Quick Access Folders
----Themes

</details> <details> <summary>(X)Exit</summary> </details>

Install

<details> <summary>Debian package install</summary>

Download debian package amd64.deb/i386.deb from release tab to any debian based Linux
install

</details> <details> <summary>Apt Package Manager</summary>

For Focal,bionic and xenial

sudo add-apt-repository ppa:kiran.kb/supreme
sudo apt-get update
sudo apt-get install supreme

For other ubuntu versions,this PPA can be added to your system manually by copying the lines below and adding them to your system's software sources.

deb http://ppa.launchpad.net/kiran.kb/supreme/ubuntu bionic main 
deb-src http://ppa.launchpad.net/kiran.kb/supreme/ubuntu bionic main

And then run the following

sudo apt-get update
sudo apt-get install supreme

If it throws error, run the following

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys C3FE0D5AC91EF80C
sudo apt-get update
sudo apt-get install supreme

</details> <details> <summary>Git Install</summary>

• First clone the repository:

git clone https://github.com/Kiran-Bose/supreme

• Then cd into the cloned directory:

cd supreme

• Run the guided install script with

. install.sh

</details>

Update

<details> <summary>Apt Package Manager</summary>

sudo apt update
sudo apt upgrade

</details> <details> <summary>Git Update</summary>

If the package is installed running '. install.sh' mentioned in Git install section, running it again will prompt for update if any.

• cd into the cloned directory:

cd supreme

• Run the guided install script with

. install.sh

</details>

Incase update fail. Uninstall and then install latest version.

Uninstall

</details> <details> <summary>Apt Package Manager/Debian package uninstall</summary>

sudo apt remove supreme

OR

sudo apt purge supreme

</details> <details> <summary>Git Uninstall</summary>

• If you don't have the supreme folder anymore clone the repository:

git clone https://github.com/Kiran-Bose/supreme

• cd into the supreme directory:

cd supreme

• run the below command

. uninstall.sh

</details>

Copyright

Copyright (C) 2021 by Kiran Bose kiran.vkvr@gmail.com

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.