Giter Club home page Giter Club logo

bashbro's Introduction

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:}$$

bashbro's People

Contributors

adamdanischewski avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.