pyrobox 🔥

Note : DEFAULT UPLOAD PASSWORD: SECret

• you can change it by editing the code (see config class at top)
• to set password from command line, use -k or --password flag

Status

Requesting for more suggesions and ideas

Feel Free to Support Me

[Email Me: ratul.hasan.coder |at| gmail |dot| com]

Basic FEATURES

• File Hosting system (Serve files from local Storage system)
• Access Shared File System from Multiple Devices
• Has optional account system (Admin can add users or allow signup) (Check Advanced Account System section)
• Set Server Permission (Check Customization Options section)

Extra FEATURES

• 🔽 DOWNLOAD AND VIDEO STREAM WITH PAUSE AND RESUME
• 🔼 UPLOAD WITH PASSWORD (User password or server-wide password)
• 👌 HTML5 drag and drop uploader
• 📈 MULTIPLE FILE UPLOAD
• 📝 RENAME
• 📁 FOLDER DOWNLOAD as ZIP (uses temp folder)
• ⏯ Built-in VIDEO PLAYER
• 🔁 DELETE FILE (MOVE TO RECYCLE BIN)
• 🔥 PERMANENTLY DELETE
• ⛓ File manager like NAVIGATION BAR
• 📑 Right click Context menu (Tap n hold on touch device)
• 🧨 RELOAD SERVER FROM REMOTE [DEBUG PURPOSE]
• 🆕 FOLDER CREATION
• 💬 Pop-up messages UI(from my Web leach repo)
• 🌐 (If you are using REAL IP AND ALLOW PYTHON TO USE PUBLIC NETWORK, YOUR SERVER CAN BE VISIBLE AROUND THE GLOBE. (you must use port forwarding from Router)
• 🧬 Clone entire directory from Host to Client with least changes (last modified preserved)
• 🔜 More comming soon
• All of these without the need of any internet connection (having connection will provide better experience)

Server side requirement

• Python 3.7 or higher. Older support available.¹
• Basic knowledge about Python
• send2trash, natsort python modules

Installation

1. Install Python 3.7 or higher
2. Close older pyrobox process if already running
3. Install using PIP

On Windows

1. Open CMD or PowerShell
2. Run pip install -U pyrobox
3. Run pyrobox to launch the server on the Terminal Current Working Directory.

On Linux

1. Open Terminal
2. Run pip3 install -U pyrobox
3. Run pyrobox to launch the server on the Terminal Current Working Directory.

CHECK FAQ FOR FUTURE HELP AND ISSUE FIX

Quick Tutorial

Customization

1. Simply running the code on will create a server on CURRENT WORKING DIRECTORY on Port: 6969

2. On browser (on device under same router/wifi network), go to deviceIP:port_number to see the output like this: http://192.168.0.101:6969/

   • you must allow python in firewall to access network, check FAQ for more help

3. To change the server running directory,

   • (i) either edit the code (see config class at top)
   • (ii) or add -d or --directory command line argument when launching the program
     • pyrobox -d . to launch the server in current directory (where the file is)
     • pyrobox -d "D:\Server\Public folder\" (Use Double-Quotation while directory has space)
     • pyrobox -d "D:/Server/Public folder" (Forward or backward slash really doesn't matter, unless your terminal thinks otherwise)

4. To change port number

   • (i) just edit the code for permanent change (see config class at top)
   • (ii) or add the port number at the end of the command line arg
     • pyrobox 45678 # will run on port 45678
     • pyrobox -d . 45678 # will run on port 45678 in current directory

5. To specify alternate bind address

   • Add bind add -bind {address} # ie: -bind 127.0.0.2 or -bind 127.0.0.99

6. To change upload password

   • (i) or add -k or --password command line argument when launching the program
     • pyrobox -k "my new password" to launch the server with new password
     • pyrobox -k "" to launch the server without password
     • pyrobox to launch the server with default password (SECret)
   • (ii) just edit the code for permanent change (see config class at top)

7. Optional configurations

usage: pyrobox [--password PASSWORD] [--no-upload] [--no-zip] [--no-update] [--no-delete] [--no-download] [--read-only] [--view-only] [--bind ADDRESS] [--directory DIRECTORY] [--version] [-h] [port]

Positional Arguments

Options

Customization Options

Advanced Account System

You must give a --name [Name] and --admin-id [USER Name], --admin-pass [PASSWORD] to create an admin account. If guest not allowed --no-guest-allowed User must login to access the server. You can also disable signing up --no-signup (Only admin can add user from admin page). Admin can also update user permission from admin page.

Account Example

1. pyrobox -n "My Server1" -aid "admin" -ak "admin123" -k "Guest_pass" # will allow anyone to access the server, but they must use Guest_pass to upload files
2. pyrobox -n "My Server2" -aid "admin" -ak "admin123" -ng # If someone wants to access the server they must sign up via signup page first. No guest allowed
3. pyrobox -n "My Server3" -aid "admin" -ak "admin123" -ng -ns # Only admin can access the server. No guest allowed, no signup allowed. Admin can add user from admin page

Clone Directory

1. Make a python file with the following code

from pyrobox import clone
clone.main()

1. Run the file. Follow the instructions.
2. For advanced use, check the source code of clone.py in the pyrobox module.

TODO

• #33 Show thumbnails, for png and jpg (how to do with just standard library?), For others, just show extension.
• #34 Copy stream URL for videos to play with any video player
• #36 Add side bar to do something 🤔
• check output ip and port accuracy on multiple os
• #37 Backup code if Reload causes unhandled issue and can't be accessed
• Add more flags to disable specific features

Support for more features

Context menu

Right click on any file link

FAQ

sudo apt -y purge python3-pip
sudo python3 -m pip uninstall pip
sudo apt -y install python3-pip
pip3 install --upgrade pip
echo "export PATH=\"${HOME}/.local/bin:$PATH\"" >>"${HOME}"/.bashrc

sudo apt -y purge python3-pip
sudo python3 -m pip uninstall pip
sudo apt -y install python3-pip
pip3 install --upgrade pip

Thanks to

1. https://github.com/bones7456/bones7456/blob/master/SimpleHTTPServerWithUpload.py (the guy who made upload possible)
2. https://gist.github.com/UniIsland/3346170 (the guy who made multiple file upload possible)
3. https://github.com/SethMMorton/natsort (sorting titles)
4. https://github.com/sandes/zipfly (modified lets you see the zip progress)
5. https://github.com/sampotts/plyr (improved video player)
6. https://github.com/transiscodev (added accunt system base Branch)

Disclaimer: the owner or the programmers or any content of this repository hold no responsibility for any kind of data loss or modification on your system and do not warrenty for such actions. I tried my best to prevent all sorts of ways (that I am currently aware of) to prevent data loss or unwanted data modification. See Data Safety Measures taken on this projects to prevent unwanted data loss.

Footnotes

1. [<=3.4 compatibility] is on the way. ↩