An ambitious nostr client
uselume.xyz »
Download for
macOS
·
Windows
·
Linux
~ Links will be added once a release is available. ~
NOTE: Lume is under active development, most of the listed features are still experimental and subject to change.
Nostr is truly censorship-resistant protocol for social network and messenger app, combine with Bitcoin, they are powerful tools bring you to freedom. Lume is one of many great clients to help you interact with them, built with Tauri and Web-tech aiming for speed and efficiency
Lume is simple as it is, no more buzzwords
Everybody runs a client. It can be a native client, a web client, etc. To publish something, you write a post, sign it with your key and send it to multiple relays (servers hosted by someone else, or yourself). To get updates from other people, you ask multiple relays if they know anything about these other people. Anyone can run a relay. A relay is very simple and dumb. It does nothing besides accepting posts from some people and forwarding to others. Relays don't have to be trusted. Signatures are verified on the client side. Learn more
When Nostr became popular, many clients exist but none of them satisfy me, so I built my own. I don't many experence in develop desktop app before, my background is just strongly in Ruby on Rails, this is also a good opportunity for me to improve my skills.
Prerequisites:
Clone repo:
Note: always use canary
branch for development
git clone -b canary https://github.com/luminous-devs/lume.git
Move to clone folder in previous step
cd lume/
Install dependencies
pnpm install
Run development build
pnpm tauri dev
First time launch app, Lume automatically create local database (sqlite) and run migrations, place at src-tauri/migrations
Database folder: tauri::api::path::BaseDirectory::App
MacOS: /Users/<username>/Library/Application Support/com.lume.nu/lume.db
In splashscreen
page, Lume will check accounts table has any account or not. If not redirect to /onboarding
. If present, run subscribe
to fetch events from DEFAULT_RELAYS
In /onboarding
page, user can import old private key
or create new .If import old key, fetch kind 0, 3
then insert to accounts table in database .If create new, show to user npub/nsec as well as random profile, then move to pre-follows page. Then redirect back to splashscreen
About Lume event processing
- Lume is using nostr-relaypool-ts to interact with relays
- When user open app, if
total notes in db == 0
, splashscreensrc/app/page.tsx
will fetch all events from 24 hours ago, if above zero, it will fetch all events sincelast time
logged - When user using app,
event collector
component have role fetch all events sincecurrent time
and save todatabase
event collector
also have role updatelast time logged
to local storage when user close the app- Newsfeed page
following or circle
will fetch event fromdatabase
then render invirtuaso
component - Lume don't render event directly after get it from relays, event will be saved in database first, and fetch via
sql query