git404hub

what is filebeam fr?

dha-aa/filebeam — explained in plain English

Analysis updated 2026-05-18

0JavaScriptAudience · generalComplexity · 2/5LicenseSetup · easy

tl;dr

A simple local network file sharing tool that lets you move files between your Mac and any phone or computer by scanning a QR code.

vibe map

mindmap
  root((filebeam))
    What it does
      Share files over LAN
      QR code access
      Upload and download
    Tech stack
      Node.js
      JavaScript
      HTTP server
    Use cases
      Move photos to a phone
      Send files to a tablet
      Share a folder locally
    Audience
      Vibe coders
      General users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Quickly send photos or files from a phone to a Mac without a cable or cloud service.

VIBE 2

Share a folder so anyone on the same Wi-Fi network can download files from it.

VIBE 3

Set up a send-only drop folder so guests can upload files but not browse existing ones.

VIBE 4

Run a get-only server so people can download shared files without being able to upload.

what's the stack?

Node.jsJavaScript

how it stacks up fr

dha-aa/filebeamabhay-pratapsingh-ctrl/chaptrabhishek-akkal/finova
Stars000
LanguageJavaScriptJavaScriptJavaScript
Setup difficultyeasyhardeasy
Complexity2/55/51/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Only works between devices on the same local Wi-Fi network, not for internet use.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

in plain english

FileBeam is a small tool for moving files between a Mac and any phone, tablet, or other computer that shares the same local network, without needing cloud storage or a cable. You start a local server, scan a QR code that appears in the terminal, and then upload or download files from a simple web page opened on the other device. It runs on Node.js version 18 or newer and works by starting an HTTP server on your machine that other devices on the same Wi-Fi network can reach. When it starts, it prints out both a local web address and a QR code, so a phone can scan the code instead of typing a URL by hand. From there, people can drag and drop files to upload them, or browse a shared folder to download files from it. FileBeam can share whichever folder you choose, defaulting to whatever folder you run it from, and it lets you pick a specific port if the default one is already in use. It also supports one-way modes: send-only, where the other device can upload but not browse files, and get-only, where people can download but cannot upload anything. If two files share the same name, FileBeam automatically renames the new one instead of overwriting it. The README also shows how to set up a shell alias so the tool can be launched from anywhere with a single word instead of typing out the full path each time. The project includes a short list of security notes, making clear it is meant only for use on a trusted local network and should never be exposed to the public internet. It blocks path traversal so a client cannot reach files outside the shared folder, and it only allows common file extensions to be uploaded. FileBeam is released under the MIT license, and stopping the server is as simple as pressing Ctrl+C in the terminal where it is running.

prompts (copy fr)

prompt 1
Walk me through installing FileBeam and sharing my Downloads folder with my phone.
prompt 2
Explain the difference between send-only and get-only mode in FileBeam.
prompt 3
Help me set up a shell alias so I can launch FileBeam from any directory.
prompt 4
Show me how to run FileBeam on a custom port if 3000 is already in use.
prompt 5
Is it safe to use FileBeam outside my home network, and what security limits does it have?

Frequently asked questions

what is filebeam fr?

A simple local network file sharing tool that lets you move files between your Mac and any phone or computer by scanning a QR code.

What language is filebeam written in?

Mainly JavaScript. The stack also includes Node.js, JavaScript.

What license does filebeam use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is filebeam to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is filebeam for?

Mainly general.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.