Skip to content

Commit f556444

Browse files
committed
v4.0.0: Drop Twitter, improve Mastodon support
1 parent 9396b25 commit f556444

File tree

5 files changed

+577
-675
lines changed

5 files changed

+577
-675
lines changed

README.md

+11-12
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
# SayMinimal
22

3-
SayMinimal is a simple, write-only¹ client to Twitter (or [Mastodon](https://joinmastodon.org/), or both). The point of SayMinimal is to map it to a keypress so you can press a button, comment on something, and then go back to what you were doing before.
3+
SayMinimal is a simple, write-only¹ client to [Mastodon](https://joinmastodon.org/). The point of SayMinimal is to map it to a keypress so you can press a button, comment on something, and then go back to what you were doing before.
44

5-
¹Technically SayMinimal also reads your most recent tweet when you ask it to thread tweets together.
5+
¹Technically SayMinimal also reads your most recent status when you ask it to thread toots together.
66

77
## Setup
88

@@ -12,23 +12,22 @@ If you've got those taken care of, you can install SayMinimal with `pip`:
1212

1313
sudo pip3 install sayminimal
1414

15-
After that, the GUI should walk you through OAuth setup. Basically, you can choose to use the default Consumer Key pair that's hard-coded into the app, or you can provide your own. I recommend you provide your own because random people can find and abuse consumer keys that are published along with the source. You also need to authorize the app to read and write to your Twitter account (verifying it with a PIN).
15+
After that, the GUI should walk you through OAuth setup. Basically, you can choose to use the default Consumer Key pair that's hard-coded into the app, or you can provide your own. I recommend you provide your own because random people can find and abuse consumer keys that are published along with the source.
1616

1717
## Config
1818

1919
SayMinimal saves its configuration in `~/.config/sayminimal/conf.yml`, which you can delete at any time to reset. The only conf saved in the current version is the four OAuth keys.
2020

2121
## Keyboard Shortcuts
2222

23-
- **Enter** - Send the current tweet.
24-
- **Shift-Enter** - Add a newline to your tweet. (It displays funky in the input text box but works)
25-
- **Alt+I** - Browse for an image to attach to the current tweet. SayMinimal currently only supports 1 media file per tweet.
26-
- **Alt+T** - Thread this tweet as a reply to your most recent previous tweet. Press again to toggle off.
23+
- **Enter** - Send the current status.
24+
- **Esc** - Exit without sending.
25+
- **Shift-Enter** - Add a newline to your status. (It displays funky in the input text box but works)
26+
- **Alt-I** - Browse for an image to attach to the current status. SayMinimal currently only supports 1 media file per toot.
27+
- **Alt-T** - Thread this status as a reply to your most recent previous status. Press again to toggle off.
28+
- **Alt-C** - Toggle content warning on post.
2729

28-
## Sentimental Historical Stuff
2930

30-
SayMinimal originated as a script I shared on the [Arch Linux forums in May of 2010](https://bbs.archlinux.org/viewtopic.php?id=96465). Man, I was _really_ a novice back then. This version of the program is much redone to take advantage of modern libraries and Twitter features.
31+
## What happened to Twitter?
3132

32-
## What about GNU Social / Mastodon?
33-
34-
SayMinimal can also post toots to Mastodon. If you have both a Twitter and Mastodon account it can post messages to both. (If the message is too long for one but not the other, it'll send one while the other returns an error. The account configuration stuff is pretty rough and there's not a good way to handle things like mentioning users in one but not the other, but that's life.
33+
SayMinimal originated as a Twitter client before adding Mastodon support. For various reasons, most notably Twitter intentionally breaking the API, SayMinimal v4.0 no longer works with Twitter. Any future development (no promises) will be focused on better Mastodon support.

0 commit comments

Comments
 (0)