BeamUP

BeamUP is a lightweight, zero-config file-sharing utility written in Python.
It instantly shares any local directory over your network — just run it and open the link shown in your terminal.

---

🚀 Features

• Share any directory instantly over HTTP
• Works on local or LAN (Wi-Fi) networks
• No setup, accounts, or cloud dependencies
• Simple command-line interface

---

🛠 Installation

1. Clone the repository:

git clone https://github.com/mrxoder/BeamUp.git

2. Install dependencies:
   Make sure you have Python 3.7+ installed, then run:

pip install -r requirements.txt

3. Make BeamUP globally accessible:

• Option 1 — Symlink (recommended):

chmod +x beamup.py
sudo ln -s "$(pwd)/beamup.py" /usr/local/bin/beamup

• Option 2 — Add project folder to PATH:

echo 'export PATH="$PATH:/path/to/beamup"' >> ~/.bashrc
source ~/.bashrc

After that, you can run beamup from anywhere in your terminal.

---

💡 Usage

beamup -d <directory> -b <host:port>

Options

Option	Description
-d <directory>	Directory to share. Defaults to your home directory if omitted.
-b <host:port>	Address to bind the server. Examples: • :8080 → binds to localhost:8080 • 0.0.0.0: → binds to all interfaces on port 6060 (default port)

Examples

beamup -d ~/Downloads -b 0.0.0.0:8080
beamup -b :9090
beamup -d /var/www

---

🌐 Accessing Your Shared Files

After you run beamup, the terminal will display something like:

Visit one of these links from another device on the same network:
  • http://localhost:8080
  • http://127.0.0.1:8080
  • http://192.168.42.1:8080

👉 Simply open one of the links shown in your terminal in a web browser (on your computer or another device connected to the same Wi-Fi network).

That’s it — your directory is instantly shared!

---

License

MIT License — free to use, modify, and distribute.