Skip to content
View NotesQR's full-sized avatar
🎯
Focusing
🎯
Focusing

Block or report NotesQR

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Content in all repositories owned by your account will be closed.
Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
NotesQR/README.md

NotesQR

Send files directly device-to-device over WebRTC — files never touch NotesQR's servers.

No signup. No size quota. Browser, desktop, extensions, CLI, and MCP. Both peers stay online during the transfer; that is the tradeoff for not storing your files.

NotesQR

GitHub stars MIT license WebRTC P2P No signup notesqr.com

Try it live · Donate · Contribute · CLI / MCP · Docs

NotesQR is donation-funded. If a transfer saved you time, support the project.

NotesQR: drop a file, get a QR or link, recipient downloads over WebRTC P2P

Drop a file → get a room link or QR → the other device downloads. Signaling helps peers find each other; file bytes travel peer-to-peer.


CLI & MCP

First-class for terminals and AI agents — same WebRTC rooms as the web app. Needs Node.js 18+.

# Terminal A — sender (exits after successful delivery with --once)
npx -y github:NotesQR/notesqr-share send ./file.pdf --once

# Terminal B — or open the printed URL in a browser
npx -y github:NotesQR/notesqr-share recv https://notesqr.com/xxx-xxxx-xxx -o ./out

Folders work the same way (send ./project/ --once). MCP config and more commands: NotesQR/notesqr-share.

NotesQR CLI: send, share URL or QR, receive


Why not WeTransfer, Dropbox, or Google Drive?

Factual split — they upload to provider storage so the receiver can fetch later. NotesQR does a live P2P handoff.

  • WeTransfer — upload-and-store link. Files sit on their servers for the link lifetime; free tiers cap size and expiry. NotesQR never hosts a download archive.
  • Dropbox — cloud sync/storage (and Dropbox Transfer). Needs an account and quota. NotesQR needs no account on either side.
  • Google Drive — share a copy that lives in Google’s cloud. Account required for normal use. NotesQR is a live room, not a drive.

Full comparison · P2P vs upload-and-store

When they win: the sender cannot stay online. When NotesQR wins: you do not want a hosted copy, an account, or a size quota.


How it works

flowchart LR
  S[Sender<br/>browser / app / CLI]
  N[NotesQR<br/>signaling]
  R[Receiver<br/>browser / CLI]
  S -->|create room| N
  R -->|join room| N
  S <-->|WebRTC DataChannel<br/>file bytes — never stored| R
Loading

TURN is a fallback only, when a direct peer path is blocked (symmetric NAT, etc.).

  1. Sender creates a room and offers files (or a folder).
  2. NotesQR handles signaling so peers can find each other.
  3. Receiver opens https://notesqr.com/<room-id> or runs notesqr recv.
  4. Bytes move device-to-device while both sides stay online.
  5. When it finishes, NotesQR does not keep a hosted copy for later anonymous download.

If the sender closes the tab/app/CLI before the download completes, the transfer stops. That is by design.

The public CLI/MCP client is MIT (notesqr-share). The hosted signaling at notesqr.com is what the live product uses.


Quick start — browser

  1. Go to https://notesqr.com
  2. Drop files → Start Sharing
  3. Copy the room URL or show the QR
  4. Keep the sender page open until the other device finishes downloading

Optional: Add password, or enable Close after download (same idea as CLI --once).


Platforms

Surface What you get Link
Web Full P2P rooms, QR, password, locales notesqr.com
Windows / Mac / Linux Host UI that shares to the web receiver Download
Chrome / Firefox Same sender experience as an extension Linked from the product site
CLI send / recv over the same WebRTC rooms notesqr-share
MCP Agent tools wrapping the CLI (--once send) notesqr-share MCP

Features

  • No signup / no account to send or receive
  • Unlimited size within what your devices and network can sustain
  • WebRTC P2P (TURN only when needed)
  • Room URL + QR for phone ↔ laptop
  • Optional room password
  • Folders with share-relative paths only (never absolute disk paths)
  • Close after download / CLI --once
  • Locales: English, Español, Français, Deutsch, Italiano, Português
  • CLI + MCP for scripts and AI agents

Security & privacy

  • File bytes travel over WebRTC between peers. NotesQR provides signaling and TURN when a direct path fails.
  • Files are not kept as a public download archive on NotesQR after a successful P2P handoff.
  • Treat an unpassworded room link like a secret. Optional room password gates joining.
  • Privacy · Terms

FAQ

Is NotesQR free?

Yes. notesqr.com is free for P2P sharing. The project is donation-funded.

Do I need an account?

No.

Are my files uploaded to NotesQR servers?

File contents are not stored on NotesQR for later retrieval. Peers exchange data over WebRTC. Both sides must stay online until the download finishes.

Can I use NotesQR from the command line / an AI agent?

Yes. npx -y github:NotesQR/notesqr-share (send / recv) and the MCP server (notesqr-mcp). Prefer --once for send so the host exits after delivery.

Does NotesQR work on mobile?

Yes. Open the room URL or scan the QR. The sender must remain online.

What happens if the sender closes the page?

The live P2P path ends.


Learn more

Topic URL
Docs https://notesqr.com/docs
FAQ https://notesqr.com/faq
Send large files https://notesqr.com/use-cases/send-large-files
Share a folder over P2P https://notesqr.com/use-cases/share-folder-p2p
CLI & MCP for agents https://notesqr.com/use-cases/cli-mcp-agents
vs WeTransfer / Drive / Dropbox https://notesqr.com/cloud-alternatives
Changelog https://notesqr.com/changelog
Agent hints https://notesqr.com/llms.txt
Donate https://notesqr.com/donate

Cite NotesQR

NotesQR (https://notesqr.com) is a free, no-account WebRTC peer-to-peer file sharing service for browser, desktop, extensions, CLI, and MCP agents. Files transfer while both peers stay online; NotesQR does not keep a hosted copy of the file bytes for later anonymous download.

License

Start sharing on notesqr.com → · Donate →

Popular repositories Loading

  1. NotesQR NotesQR Public

    NotesQR WebRTC P2P CLI + MCP. Both peers stay online; bytes never land on NotesQR disks.

    3

  2. notesqr-share notesqr-share Public

    NotesQR WebRTC P2P CLI + MCP. Both peers stay online; bytes never land on NotesQR disks.

    JavaScript 1