getting_started

Getting Started

(option 1) Download jar file

This is generally a few pushes behind and may not have all the features.
https://www.dropbox.com/s/cpybfjjnfr548ti/more-speech-0.1.0-SNAPSHOT-standalone.jar?dl=0

(optional) Cloning this repository.

• You will need Clojure and Leiningen.
• Edit the project.clj file. Find the :java-cmd line and change the path to your Java 17 implementation. You may be able to delete this line if you have java17 normally installed.
• To run the tests: lein spec
• To run the tests with an auto-runner: lein spec -a

Setup

To run the application.

• If you cloned the repository, you can do that with lein run.
• If you downloaded the jar file type java -jar more-speech-0.1.0-SNAPSHOT-standalone.jar

The first time you run the application it will do most of the setup for you. The main window will pop up, and if you click the all tab you'll see some messages begin to fill in. More-speech has generated a private and public key for you, and given you a temporary user name. More-speech has also given you two tabs. The 'all' tab displays all the messages it is receiving on the connected relays. The 'follow' tab follows me (unclebobmartin) and will show every message that I post, and every message that others post that reference me. (e.g. replies to my messages). You'll be able to add more people to this tab using the popup menus on articles.

Select the Manage->Stats... menu and notice that the Backlog is probably in the thousands. That's because more-speech has requested a lot of information from the nostr relays, and is trying desperately to crank through them all. Be patient. Wait for the backlog to drop to zero. After that, things will get better.

While you are waiting I recommend that you invoke the Manage->Profile... menu and fix up your name. If you like you can add the about and picture too. You can research the other fields later. And if you already have public and private keys from some other source, you can replace the automatically generated ones by entering the private key, in hex or nsec format, in the appropriate field.

Once you quit the app you will find several files in the private directory. You may wish to edit some of them.

• private/keys Your personal profile. Don't touch! This is managed using the Manage->Profile... menu. The private key is encrypted with a password. The default password is "password".
• private/user-configuration Configuration variables allowing you to control more-speech behavior.
• private/relays The nostr relays you read from and write to. This is better changed by using the Manage->Relays... menu. But if you must you can make changes here.
• private/tabs-list The tabs you want, and the filters they employ. Many of the changes you may want to make to this file can be made by using the popup menus on articles or on the tabs themselves. But if you must you can also edit things in this file.
• private/migration Contains the migration level (version number) of the data files. Don't touch!

The next thing you'll want to do is find one or more of the many paid relays like eden.nostr.land and atlas.nostr.land. Pay the small fee and add it to your relays with :read-all by invoking the Manage->Relays... menu. You'll get a lot of events, but not a lot of spam. After that you can start interacting with folks pretty easily. You'll eventually want to add more relays and more trusted contacts and more tabs.