How to use nanotodon on OpenBSD

0. What is nanotodon?

Nanotodon is text-based Mastodon client developed by kagura1050(Takaki Yoda).

1. Install required libraries

We can use net/curl and devel/json-c in OpenBSD packages collection.

# pkg_add curl json-c

2. Get nanotodon source from github

% git clone https://github.com/taka-tuos/nanotodon

3. Apply patch

Apply following patch. Recent nanotodon does not need any modification in c source, this patch generates OpenBSD dedicated Makefile. It should be work on both OpenBSD/amd64 (and possibly OpenBSD/luna88k) with original nanotodon source as of Oct 13, 2020.

https://gist.github.com/ao-kenji/d38e128f50f1356afcf5747021d5f878

4. Make

% cd nanotodon
% make -f Makefile.bsd-wrapper

If you like, copy executable binary 'nanotodon' to your favorite place, like /usr/local/bin or ~/bin.

5. First time run

Recent nanotodon supports English guidance messages. If you do not set environment variable LANG to 'ja_JP.UTF-8', the English messages will be used. Please run nanotodon in UTF-8 compatible terminal, like x11/mlterm in OpenBSD packages collection.

% nanotodon
Hello! Welcome to nanotodon!
First, please tell me the instance where you live.
(https://[please enter this part]/)
>

In my case, put my instance "bsd.network", and [enter].

% nanotodon
Hello! Welcome to nanotodon!
First, please tell me the instance where you live.
(https://[please enter this part]/)
>bsd.network

Next, I will do application authentication.
Please access to following URL, then after authorization, please input displayed authorization code.
https://bsd.network/oauth/authorize?client_id=..(snip)
>

Then copy the URL and paste it on some browser to access authorization page. Next, copy the authorization code displayed on the browser, and paste it on nanotodon terminal, press [enter]. After input authorization code, you will see the main screen!

Note: this initial settings are stored in ~/.config/nanotodon folder.

6. How to toot

Write your toot text on top-half of the screen. Then press [ESC] to toot.

7. Acknowledgment

Original nanotodon author kagura1050(Takaki Yoda) / github: taka-tuos / Mastodon: @[email protected]

8. Author

Kenji Aoyama / 青山健治 / Twitter: @ao_kenji / Mastodon: @[email protected]

ABSOLUTELY NO WARRANTY

ao-kenji/obsd-nanotodon-memo.md