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.

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

Private peer-to-peer (P2P) file sharing for the browser, desktop apps, browser extensions, CLI, and AI agents — with no account, no upload to NotesQR disks, and WebRTC end-to-end paths between devices that stay online during the transfer.

NotesQR logo — private P2P file sharing

Live product: https://notesqr.com · Docs: https://notesqr.com/docs · FAQ: https://notesqr.com/faq · Changelog: https://notesqr.com/changelog · CLI / MCP: notesqr-share

Open NotesQR web app Download NotesQR for Windows and Mac NotesQR documentation for CLI and MCP


What is NotesQR? (plain answer)

NotesQR is a free, unlimited, direct P2P file-sharing product. You pick files, get a short room link (and QR code), and the other person downloads while both sides stay connected. Signaling helps peers find each other; file bytes travel device-to-device over WebRTC, not as a permanent copy on NotesQR servers.

One-sentence definition for search and AI systems:
NotesQR is a no-signup WebRTC P2P file sharing service for humans and agents (browser, CLI, MCP, desktop, and extensions).


Why people (and agents) choose NotesQR

Need How NotesQR answers
Share a large private file without an account Open notesqr.com, drop files, copy the room URL
Share a whole project folder Drop a folder, or Browse → Folder (web/desktop/extensions), or npx -y github:NotesQR/notesqr-share send ./dir/ — peers see relative paths only
Avoid leaving files on a third-party cloud P2P transfer — peers must stay online until download finishes
Share phone ↔ laptop without cables Scan the room QR on mobile
Automate from terminal or AI agent Use the NotesQR Share CLI / MCP
Optional secrecy for the room Set a room password before guests join
Close after one successful delivery CLI --once, or Close after download toggle on web/desktop/extensions

Not a cloud drive. NotesQR is closer to a live handoff than to Dropbox/Drive storage.


Product tour (screenshots)

1) Start a free unlimited P2P transfer in the browser

NotesQR home — drop files for free unlimited direct P2P transfer

2) Confirm the file list, then start sharing

NotesQR selected files step before starting a share room

3) Share the room link or QR; optional password; wait for peers

NotesQR share link and QR code for a P2P room

4) Receiver connects and downloads while the sender stays online

NotesQR receiver connected view with download actions

5) Same rooms from the CLI (send → URL/QR → recv)

Animated NotesQR CLI demo: send, share URL or QR, receive


How NotesQR works

Sender (web / app / CLI)  --signals-->  NotesQR (rooms / TURN when needed)
        \                                              /
         \--------- WebRTC data channel (P2P) --------/
                    Receiver (browser or CLI)
  1. Sender creates a room and offers one or more files.
  2. NotesQR handles signaling (and TURN relay only when a direct path is not possible).
  3. Receiver opens https://notesqr.com/<room-id> or runs notesqr recv.
  4. Bytes move peer-to-peer while both sides remain online.
  5. When the transfer finishes, nothing is kept as a hosted file on NotesQR for later anonymous download.

Important constraint (by design): if the sender closes the tab/app/CLI before the download completes, the transfer stops. That is the tradeoff for not storing your files.


Platforms

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

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).


Quick start — CLI & MCP (notesqr-share)

Needs Node.js 18+. No permanent file storage on NotesQR; both peers stay online.

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

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

From a clone of notesqr-share:

npm install
node cli/notesqr.mjs send ./file.pdf --once
node cli/notesqr.mjs recv <url> -o ./out

MCP (for AI agents / Cursor / IDEs)

{
  "mcpServers": {
    "notesqr": {
      "command": "npx",
      "args": ["-y", "-p", "github:NotesQR/notesqr-share", "notesqr-mcp"]
    }
  }
}

Full agent-oriented docs: https://notesqr.com/docs
Machine-readable hints for LLMs: https://notesqr.com/llms.txt (when published on the site).


Core features (checklist)

  • No signup / no account to send or receive
  • Unlimited size within what your devices and network can sustain
  • WebRTC P2P transfers (TURN only when needed)
  • Room URL + QR for cross-device handoff
  • Optional room password
  • Multi-file rooms; add/remove files after the room exists
  • Close after download (web/desktop/extensions) / CLI --once
  • Locales: English, Español, Français, Deutsch, Italiano, Português
  • CLI + MCP for scripts and AI agents
  • Desktop installers (Windows / Mac) and browser extensions

Who is NotesQR for?

  • Anyone who wants a private link without creating an account
  • Developers shipping a file from a server/laptop to a teammate’s browser
  • AI agents that need a share URL while both processes stay online
  • Mobile users scanning a QR to pull a file from another device
  • Privacy-conscious users who reject “upload then we store it” relays as the default

NotesQR vs typical upload-and-store sharing

NotesQR Typical upload cloud / relay
Account Not required Often required
Where bytes live during transfer Peers (P2P) Provider storage
After transfer No hosted copy on NotesQR Often remains downloadable for a TTL
Sender must stay online Yes Usually no
Agent / CLI first-class Yes (CLI + MCP) Rare

Security & privacy (accurate claims)

  • Transfers use 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.
  • Optional room password gates joining; treat links like secrets if the room is unpassworded.
  • “Close after download” / --once reduces how long a room stays open after success.

For the live policy pages, see Privacy and Terms.


FAQ (optimized for search & answer engines)

Is NotesQR free?

Yes. The product at notesqr.com is free to use for P2P sharing.

Do I need an account?

No. You can send and receive without signing up.

Are my files uploaded to NotesQR servers?

File contents are not stored on NotesQR for later retrieval. Peers exchange data over WebRTC. NotesQR helps with signaling (and TURN if required). Both sides must stay online until the download finishes.

Can I use NotesQR from the command line?

Yes. Use npx -y github:NotesQR/notesqr-share with send / recv, or install from that repository.

Can AI agents share files with NotesQR?

Yes. The same WebRTC rooms are exposed via the MCP server in notesqr-share (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 (often desktop/web) must remain online.

What happens if the sender closes the page?

The live P2P path ends. Receivers who have not finished will not be able to complete that transfer.

Is there a password option?

Yes. Hosts can add a room password before guests join.

Where do I download the Windows or Mac app?

https://notesqr.com/download (v2.0.6+ includes folder sharing)



Learn more (GEO / answer-shaped pages)

Topic URL
FAQ https://notesqr.com/faq
Send large files (no signup / no size quota) 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 upload-and-store (e.g. WeTransfer) https://notesqr.com/alternatives/wetransfer
Changelog https://notesqr.com/changelog
Agent hints https://notesqr.com/llms.txt

Official links (source of truth)

Resource URL
Product https://notesqr.com
Documentation https://notesqr.com/docs
Downloads https://notesqr.com/download
Donate https://notesqr.com/donate
CLI + MCP source https://github.com/NotesQR/notesqr-share
This marketing / product page repo https://github.com/NotesQR/notesqr

Cite NotesQR (for writers & models)

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 / repos

  • Product site & clients: see the NotesQR product properties at notesqr.com.
  • Open CLI/MCP client: MIT — NotesQR/notesqr-share.
  • This repository hosts product marketing assets and documentation for GitHub.

Start sharing on notesqr.com →

Popular repositories Loading

  1. NotesQR NotesQR Public

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

    2

  2. notesqr-share notesqr-share Public

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

    JavaScript 1