PrivacyNotes.app README

README проекта с github.com/LifetimeLabsHQ/PrivacyNotes.app. Одним файлом markdown: README.md.

PrivacyNotes

Notes, tasks, and journal, encrypted on your device.
Your 12-word phrase is your identity and your key. With a phrase sign-up there is no email, no password and no account to leak.

Website  ·  Try it, no account  ·  Verify it yourself  ·  Security  ·  Threat model

Signed apps for macOS, Windows, Linux, Android and iOS, or run it in the browser.

License: AGPL v3 Encryption Release Stars GitGem


The PrivacyNotes app

This screenshot is a link. It opens the live demo in your browser:
no account, nothing saved, the real app with the real encryption.


What your data looks like on our server

Real rows from the notes table, containing only ciphertext

Real rows from the notes table in production. A public key, a ciphertext, a nonce.
No title, no body, no tags. Just bytes that only your phrase opens.


Do not take our word for it. Check it yourself in about a minute, with nothing but your browser's network tab.


PrivacyNotes GitHub stats on PrivacyTools.io

What PrivacyNotes is

A notes, tasks and journal app for macOS, Windows, Linux, Android, iOS and the browser, encrypted on your device. You get a 12-word phrase instead of an account, and everything you write is encrypted on your device under a key derived from it, on disk and on the way to us. Under self-custody, that key is yours alone. Notes, journal entries, tasks, a password vault, and file attachments all live under that one key.


Why this repo exists

Privacy claims need proof. The parts you actually have to trust are here: the client applications, the cryptographic core, and the threat model - the real files that ship, not summaries. Reading crypto.ts proves the encryption is sound; having the client around it proves the encryption is used on every path.

Three claims we make, and where to check each one without taking our word for it:

The claim Check it here
Under self-custody, your phrase never leaves your device crypto/crypto.ts, and the derivation strings in the live bundle
Your notes are encrypted on your device, at rest and on the way to us crypto/crypto.ts, the XChaCha20-Poly1305 path
The server stores only ciphertext VERIFY.md tier 1: watch your own notes leave in your browser's network tab

If any of those stops holding, the claim is broken and you can prove it. That is the entire point of this repo.

The first claim holds under self-custody, which every phrase sign-up uses. Its exception is custodial mode, which a sign-up with Google, Apple or GitHub preselects.


What is in here

Path What it is
application/ The client applications, as we build them: the web app, the desktop and mobile shells, and the shared crypto package. cd application && pnpm install && pnpm build.
crypto/crypto.ts Key derivation and note encryption, about 650 lines, commented step by step. Not a reference implementation. The production code, copied here so the link is short; the canonical file is application/packages/shared/src/crypto.ts. Attachments and images use the same cipher through crypto/blob.ts, which is another 50 lines.
SECURITY.md What we protect against, what we do not, and what the server can see. Written for users.
THREAT_MODEL.md Trust boundaries, cryptographic detail, and known limitations, including the unflattering ones. Written for auditors. Start here if you are reviewing the project.

The design in brief

Identity and key derivation. A 12-word BIP-39 mnemonic (128 bits of entropy) is generated on your device and turned into a 64-byte seed via the standard BIP-39 PBKDF2 path. Every key comes out of that seed via HKDF-SHA256, each under its own domain-separated info string so that no two uses share key material:

Info string Produces Used for
privacynotes-signing-v1 Ed25519 private key Its public key is your user ID
privacynotes-encryption-v1 32-byte symmetric key Note, attachment and image encryption
privacynotes-local-at-rest-v1 32-byte symmetric key Seals note content at rest in the device's own storage; never stored, never transmitted
privacynotes-auth-password-v1 32-byte secret The password for the anonymous account that carries your session
privacynotes-fp-pepper-v1 32-byte pepper Hashes the device-grouping signals described in SECURITY.md, so the server never sees the raw values

Note encryption. Each note is encrypted with XChaCha20-Poly1305 under a random 24-byte nonce. The plaintext payload includes title, body, tags, and metadata such as trashed and starred state. The server sees none of it. The 24-byte nonce is what makes random generation safe without collision risk, unlike AES-GCM's 12 bytes.

Challenge signing. Pubkey-to-account binding uses Ed25519 signatures over structured challenges (link:<authUid>). Device registration and revocation use the same shape. Every signature binds to the session's auth UID, so a captured signature cannot be replayed into another session.

Dependencies, all from the @noble and @scure families: @scure/bip39, @noble/hashes, @noble/ed25519, @noble/ciphers. Zero dependencies each, written to be auditable, deployed in production by major wallets.


Verify it yourself

Read it. crypto/crypto.ts is one file and you can finish it in a sitting.

Run the derivation. The same path the app uses, from the same audited packages, in a scratch directory you can delete afterwards. Copy the whole block:

mkdir -p /tmp/pn-verify && cd /tmp/pn-verify
npm install --silent @scure/bip39@^2 @noble/hashes@^2

node --input-type=module -e "
import { generateMnemonic, mnemonicToSeedSync } from '@scure/bip39';
import { wordlist } from '@scure/bip39/wordlists/english.js';
import { hkdf } from '@noble/hashes/hkdf.js';
import { sha256 } from '@noble/hashes/sha2.js';

const utf8 = new TextEncoder();
const hex  = b => Buffer.from(b).toString('hex');

const phrase = generateMnemonic(wordlist, 128);
const seed   = mnemonicToSeedSync(phrase);
const encKey = hkdf(sha256, seed, undefined, utf8.encode('privacynotes-encryption-v1'), 32);
const sigKey = hkdf(sha256, seed, undefined, utf8.encode('privacynotes-signing-v1'), 32);

console.log('Phrase           :', phrase);
console.log('Encryption key   :', hex(encKey));
console.log('Signing key      :', hex(sigKey));
console.log('Deterministic    :', hex(hkdf(sha256, mnemonicToSeedSync(phrase), undefined, utf8.encode('privacynotes-encryption-v1'), 32)) === hex(encKey));
console.log('Domain-separated :', hex(encKey) !== hex(sigKey));
"

Two lines of that output are the ones that matter. Deterministic: true says the phrase alone reproduces the key, on any machine, forever, with nothing fetched from us. Domain-separated: true says the signing key and the encryption key cannot be derived from each other, so publishing your user ID does not leak the key your notes are under.

Diff it against production. The bundle is minified, so a textual diff is not practical, but the derivation is falsifiable anyway. Open the JavaScript served at PrivacyNotes.app and search it for privacynotes-signing-v1 and privacynotes-encryption-v1, the HKDF-SHA256 construction, and XChaCha20-Poly1305 with 24-byte nonces. They are in there right now. If they ever are not, we are lying and you can show it.

Watch the wire. The strongest check needs no source at all. Open your browser's network tab, type a word into a note, and read what the app sends: a ciphertext, a nonce, a public key and timestamps. No title, no body, nothing you typed. VERIFY.md walks it in about a minute. It beats reading our table definitions, because it measures what actually leaves your machine rather than what we say we store.


The parts that are not absolute

SECURITY.md states each one in full, and THREAT_MODEL.md says how it works.

Custodial mode, the exception to the first claim

A sign-up with Google, Apple or GitHub preselects custodial mode: your phrase is kept on our server under a key we hold, so we could decrypt your notes. A phrase sign-up never uses it, and Settings > Account > Key custody switches either way. SECURITY.md has the full trade.

The rest, one line each


Security contact

Found a flaw in the crypto, the derivation, or the client? Report it privately on GitHub rather than opening a public issue, so it can be fixed before it is public. A private report there reaches us fastest and keeps the whole exchange in one place.

If you cannot use GitHub, email [email protected] as a backup. That address is also published in our security.txt on our own domain, so you can confirm it is really us. If a fix needs coordination we will work with you on timing before disclosure. There is no paid bounty program yet.

No third-party audit has been performed yet. The first serious spend out of revenue is one, with Cure53 as the target firm.


Credits

PrivacyNotes is shaped by the people who report bugs and ask for features in our issues. 104 people have opened an issue, and 436 reports are now fixed or built.

tech2-user harishbewe scamidge Real-Fruit-Snacks AndreFeliciano les-incompetent mburr MrJarvisHere laulaugaby Tobias1000 block6791 shriganesh grub-basket deftly1970 TheArtForm pdmcgeejr javaskript snogglefromp thecoffeebin gijs-epping KamikazeWolf michaeldurland ajgraves FrostyLime gitglub GregHabiskis BackupSFG tactfuljeer 825i thediamondgeezer ylnztrkk ameetjeeva

Everyone, with their counts, is in CREDITS.md.


License

This repository is AGPL-3.0. Read it, audit it, build it, fork it. If you run a modified version as a network service, publish your changes.

The name PrivacyNotes, the wordmark and the icon are not part of that grant. A fork needs its own name.

The PrivacyNotes app icon

Writing about PrivacyNotes? The square app icon is assets/icon.svg, and the full brand kit, with lockups and usage rules, is at privacynotes.app/brand. NOTICE.md says what the license grant does not cover.

A note on the earlier MIT releases of the encryption files is in crypto/README.md.

The app is built on other open source software. Every package, font and crate it includes, each with its license, is listed at privacynotes.app/licenses.

PrivacyNotes.app (LifetimeLabsHQ/PrivacyNotes.app)

Ищем в базе…

Что это такое?PrivacyNotes — это приложение со сквозным шифрованием для заметок, задач, дневника, хранилища паролей, файлов и закладок. Доступно для macOS, Windows, Linux, Android, iOS и в браузере. Вместо электронной почты и пароля вы получаете фразу из 12 слов по стандарту BIP-39, которая одновременно является и вашим идентификатором, и ключом шифрования, поэтому нет аккаунта, который мог бы утечь.
Это только исходный код криптографии или полноценное рабочее приложение?Это полноценное кроссплатформенное приложение с подписанными нативными сборками для macOS, Windows, Linux, Android и iOS, а также веб-версия. В репозитории также опубликован полный исходный код клиента, ядро шифрования (crypto/crypto.ts) и модель угроз, чтобы заявления о приватности можно было проверить независимо.
Как начать пользоваться PrivacyNotes?Откройте PrivacyNotes.app в браузере, чтобы попробовать сразу, без регистрации, или установите подписанное приложение для своей платформы и зарегистрируйтесь с только что сгенерированной фразой из 12 слов. Чтобы собрать клиент из исходного кода: 'cd application && pnpm install && pnpm build'.
Нужны ли email или пароль для регистрации?Нет — для регистрации по фразе нужно только устройство, которое сгенерирует вашу мнемоническую фразу из 12 слов по BIP-39; ни почты, ни пароля, ни аккаунта не требуется. Сама криптография опирается только на прошедшие аудит библиотеки @noble и @scure (bip39, hashes, ed25519, ciphers).
Что будет, если я потеряю фразу из 12 слов?При самостоятельном хранении ключей потеря фразы означает безвозвратную потерю заметок — сброса пароля нет, так как команда считает сброс бэкдором. Вход через Google, Apple или GitHub по умолчанию предполагает хранение фразы на их серверах, что нарушает гарантию полного самостоятельного хранения ключей.
Что сервер может увидеть о моих заметках?Только шифротекст: открытый ключ, nonce и байты, которые расшифровать может только ваша фраза — ни заголовка, ни текста, ни тегов. Сервер при этом видит метаданные: ваш псевдонимный открытый ключ, длину шифротекста, временные метки, количество заметок, паттерны синхронизации и IP-адрес запроса.
В чём подвох с лицензией AGPL-3.0?Код можно свободно читать, проверять, собирать и форкать, но если вы запускаете изменённую версию как сетевой сервис, то обязаны опубликовать свои изменения. Название PrivacyNotes, логотип-надпись и значок не входят в действие лицензии, поэтому форк должен иметь собственный брендинг.
Что такое кастодиальный режим и зачем его выбирать?Если вы регистрируетесь через Google, Apple или GitHub вместо фразы, PrivacyNotes хранит вашу фразу на своих серверах, зашифрованной ключом, который хранит компания. Это делает настройку нового устройства одним нажатием вместо ввода 12 слов, но нарушает гарантию самостоятельного хранения ключей и подвергает вас риску по требованию властей или в случае компрометации компании.
Как проверить заявления о шифровании самостоятельно?Можно прочитать crypto/crypto.ts (около 590 строк), запустить скрипт деривации ключей, чтобы убедиться, что он детерминированный, поискать строки доменов HKDF в работающем JavaScript-бандле или открыть вкладку сети в браузере и увидеть, что при сохранении заметки уходят только шифротекст, nonce и открытый ключ.
Код проверял кто-то из сторонних аудиторов?Стороннего аудита пока не проводилось; команда говорит, что первые серьёзные расходы из выручки пойдут именно на него, а целевой компанией является Cure53.
Поддерживает ли PrivacyNotes пароли и вложения, а не только заметки?Да — тот же ключ шифрования охватывает заметки, записи дневника, задачи, хранилище паролей и вложения-файлы или изображения, которые шифруются на устройстве с помощью XChaCha20-Poly1305 до того, как что-либо покинет ваше устройство.
Какие есть похожие проекты?ente, siyuan, Trilium, notesnook, edgeever, joplin, logseq, AFFiNE
Автор
LifetimeLabsHQ
Размер
146.8 MB
Звёзды
699
Возраст
6 мес
Коммиты · 90 дней