Skip to content

A Bash-based web file browser. Allowing you to browse, view and transfer files via your web browser.

License

Notifications You must be signed in to change notification settings

victrixsoft/bashbro

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

35 Commits
 
 
 
 
 
 
 
 

Repository files navigation

bashbro

A Bash-based web file browser - allowing you to remotely browse, stream, view documents and save files via your web browser. Runs on Windows via WSL.

Bashbro Usage

Usage

To start bashbro locally on port 5555:

$> bashbro -s -p 5555
   -or- (condensed syntax)
$> bashbro -sp5555

To start bashbro on port 7878, jailing to dir /tmp:

$> bashbro -sp7878 -j/tmp 

Serve a single file on port 7878, jailing to file /path/to/file:

bashbro -sp7878 -j/path/to/file 

Note

When you jail to a file, bashbro will serve only that single file.

Remotely


To start bashbro on a remote server:

  1. Copy bashbro to the remote server
  scp bashbro <youruser>@<server name/ip>:
  1. Run bashbro
ssh <youruser>@<server name/ip> ./bashbro -s -p=<port>

After launching bashbro, open a browser to <server name/ip>:<port>.


Bashbro Demo

Downloading

Tip

To avoid downloading big images in assets branch, clone it like this:
git clone https://github.com/victrixsoft/bashbro.git --depth 1

You can also fetch and run bashbro directly (e.g. get/run on port 6556):

curl -O https://raw.githubusercontent.com/victrixsoft/bashbro/main/bashbro && chmod +x bashbro && ./bashbro -sp6556
wget -O bashbro https://raw.githubusercontent.com/victrixsoft/bashbro/main/bashbro && chmod +x bashbro && ./bashbro -sp6556

Tip

When using Chrome browser localhost may be blocked, in that case you can use your ip for instance 192.168.1.55:8880 - no tickets on this plz, it's a Windows/Chrome thing.

$${\color{orange} Requirements:}$$

About

A Bash-based web file browser. Allowing you to browse, view and transfer files via your web browser.

Resources

License

Stars

Watchers

Forks

Packages