defnotgustavom/neonmodem repository overview

First, create a config file with:

                 docker run -it --rm -v /neonmodem/config/dir/:/.config/ --name="moo" -u root defnotgustavom/neonmodem neonmodem connect --type name --url http://ur.l (read below for more info)

Then, change ownership of the neonmodem.toml file by typing the following:

                  sudo chown nobody /neonmodem/config/dir/neonmodem.toml

Then rerun it with the following:

                 docker run -it --rm -v /neonmodem/config/dir/:/.config/ --name="moo" --log-driver none defnotgustavom/neonmodem neonmodem

Neon Modem Overdrive is a BBS-style command line client that supports Discourse, Lemmy, Lobsters and Hacker News as backends, and seamlessly integrates all of them into a streamlined TUI. And yes, you heard that right, I really did call it Neon Modem Overdrive.

Neon Modem is built in Go, using Charm's Bubble Tea TUI framework, but implements an own window manager (or compositor if you want) that allows it to use a third dimension, on top of the two dimensional rendering that Bubble Tea offers today. With that it is possible to display dialogs on top of one another, in order to offer a smoother UI experience.

• Configuration

Before launching Neon Modem Overdrive it requires initial setup of the services (a.k.a. systems). Run neonmodem connect --help to find out more.

Connecting a service will add it to the configuration TOML.

• Systems

• Discourse

For connecting to a Discourse instance you'll need to have an active account on that instance. Neon Modem will store the instance URL, username and a user key, but no password.

neonmodem connect --type discourse --url https://www.keebtalk.com⁠

• Lemmy

For connecting to a Lemmy instance you'll need to have an active account on that instance. Neon Modem will store the instance URL, username and password.

neonmodem connect --type lemmy --url https://lemmy.ml⁠

• Lobsters

For connecting to a Lobsters instance you won't need an account, as the integration is read-only. Neon Modem will store the instance URL.

neonmodem connect --type lobsters --url https://lobste.rs⁠

• Hacker News For connecting to Hacker News you won't need an account, as the integration is read-only.

neonmodem connect --type hackernews

• UI

The UI can be fully customized via the Theme section in the configuration file. To reset settings, all theme related configurations can simply be deleted from the configuration.

• Navigation

In the posts list:

j: Scroll down

k: Scroll up

r/enter: Open selected post

n: Write new post in on the system/forum of the current selected post

C-e: Open system selector

C-t: Open forum selector

q/esc: Quit

In the post view dialog:

r: Reply to post

#r: Reply to specific comment # in post, e.g. 3r to reply to the reply #3

z: Load older replies (if available)

esc: Close dialog

In the new post / new reply dialog:

tab: Switch between elements (only in new post dialog)

C-s: Submit post/reply

esc: Close dialog