Local Aura Beam

The foolproof guide to building a private, high-speed bridge between your computer and your phone over Wi-Fi. No file limits. No cloud storage. No internet required.

1 Install the Engine (Python)

Your computer needs an engine called Python to run the server. Installing it is exactly like installing a new web browser.

Mac Users

  1. Go to python.org & download the latest version.
  2. Open your Downloads folder and double-click the .pkg file.
  3. Click Continue/Agree/Install through the prompts.

Windows Users

  1. Go to python.org & download the Windows installer.
  2. Double-click the downloaded setup file.
  3. Follow the prompts and click Install.

Common Pitfalls: Don't Skip These!

  • Mac: When installation finishes, a folder automatically opens. You MUST double-click Install Certificates.command or your server won't be able to talk to the network properly.
  • Windows: On the very first installation screen, you MUST check the box at the bottom that says Add python.exe to PATH before clicking Install.

2 Create the Vault & Save the Code

  1. Create a new folder on your computer's Desktop and name it: AuraBeam
  2. Open your computer's plain text editor (TextEdit on Mac, Notepad on Windows).
  3. Copy the giant block of code below, paste it into the empty document.
  4. Save the file inside your new AuraBeam folder as exactly: beam.py

The Mac "SyntaxError" Trap

If your terminal spits out an error about {\rtf1..., it means Mac's TextEdit saved it as a Rich Text document with invisible fonts.

The Fix: Open the file in TextEdit, click Format in the top menu bar, and select Make Plain Text. Delete everything, re-paste the code below, and save.

beam.py

3 Install the Missing Piece (Flask)

Your computer needs a tiny piece of software called Flask to display web pages. You only have to do this once.

  1. Open your terminal (Cmd + Space, type "Terminal" on Mac. Start Menu, type "Command Prompt" on Windows).
  2. Copy and paste this exact command, then hit Enter:
Mac pip3 install flask
Windows pip install flask

4 Fire It Up

You are fully set up. Whenever you want to transfer files, do this:

1

Point your terminal to the folder

cd Desktop/AuraBeam
2

Turn on the bridge

python3 beam.py (Mac)
python beam.py (Windows)

Browser Security Panic!

Modern browsers like Firefox are trained to panic when a site uses http:// instead of https://. Because this server is living entirely inside your private home Wi-Fi network, it is perfectly safe to ignore this.

  • "Secure Site Not Available": Click the button that says Continue to HTTP Site.
  • "Potential Security Risk": Click Advanced... then click Accept the Risk and Continue.
  • "Not Found" / 404 Error: If you manually typed the URL, make sure it ends exactly at the number 5000. Do not add /beam.py to the end of the link in your browser!

5 Bonus: Turn it into a Mac App

Tired of opening the terminal? Use Apple's built-in Automator to make a clickable desktop app.

  1. Press Cmd + Space, type Automator, and hit Enter.
  2. Click New Document, select Application, and click Choose.
  3. Search for Run AppleScript in the top-left and drag it into the empty space on the right.
  4. Delete the placeholder text and paste this:
    tell application "Terminal"
        do script "cd ~/Desktop/AuraBeam && python3 beam.py"
        activate
    end tell
  5. Click File > Save. Name it Aura Beam and put it in your Applications folder. You can now just double-click that app icon to start your server!

Local Aura Beam

You are connected securely over local Wi-Fi.
Files uploaded here are saved directly to your desktop's beam_vault folder.

Beam a Photo

The Vault

{% for file in files %}
{% endfor %} {% if not files %}

The vault is currently empty.

{% endif %}
""" @app.route('/') def index(): local_ip = get_local_ip() # Sort files by newest first based on modification time files = [f for f in os.listdir(UPLOAD_FOLDER) if f.lower().endswith(('.png', '.jpg', '.jpeg', '.gif', '.webp'))] files.sort(key=lambda x: os.path.getmtime(os.path.join(UPLOAD_FOLDER, x)), reverse=True) return render_template_string(HTML_TEMPLATE, ip=local_ip, files=files) @app.route('/upload', methods=['POST']) def upload(): # Save the incoming file to the vault folder if 'file' in request.files: file = request.files['file'] if file.filename != '': file.save(os.path.join(UPLOAD_FOLDER, file.filename)) return redirect('/') @app.route('/files/') def serve_file(filename): return send_from_directory(UPLOAD_FOLDER, filename) if __name__ == '__main__': local_url = f"http://{get_local_ip()}:5000" print(f"\nšŸš€ Aura Beam Server Started!") print(f"šŸ“± Connect your phone to the same Wi-Fi and open this exact link:") print(f"šŸ‘‰ {local_url}") # Opens your default web browser 1 second after the server starts threading.Timer(1, lambda: webbrowser.open(local_url)).start() # Run the server app.run(host='0.0.0.0', port=5000)