Skip to main content

SayMinimal

SayMinimal is a simple, write-only¹ client to Mastodon. 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.

¹Technically SayMinimal also reads your most recent status when you ask it to thread toots together.

Setup

SayMinimal requires Python 3, Gtk+ 3, and PyGObject.

If you've got those taken care of, you can install SayMinimal with pip:

pip install sayminimal

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.

Config

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.

Keyboard Shortcuts

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

What happened to Twitter?

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.

Metadata

Release files for sayminimal 4.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for sayminimal 4.1.0
File Size Uploaded
sayminimal-4.1.0.tar.gz 23.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for sayminimal 4.1.0
File Interpreter ABI Platform
sayminimal-4.1.0-py2.py3-none-any.whl Python 2, Python 3 none any Details

Total release size: 45.3 kB

Release files / sayminimal-4.1.0.tar.gz

Download URL sayminimal-4.1.0.tar.gz
Size 23.1 kB
Tags Source
SHA-256 checksum
How to use checksums
2cc9f746278125433c2cd51b1fc9b23c12a1b4ea864f1139148fef1c30e2ca24
BLAKE2b-256 checksum
How to use checksums
b3d82c9612aded051b48a92971269acfe72d7050f3923f874159c10bc4f962c9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Release files / sayminimal-4.1.0-py2.py3-none-any.whl

Download URL sayminimal-4.1.0-py2.py3-none-any.whl
Size 22.2 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
700ca1aeb0ac7e401d035f0b4557fe9fc167a5768d047e5730c372be0df659d2
BLAKE2b-256 checksum
How to use checksums
9440b56a498afff0c9557136905048387ed50679e26cd33e5a67a3342eefcd2c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Release history Release notifications | RSS feed

This release

4.1.0 This release

2 release files

4.0.0

2 release files

3.0.2

2 release files

3.0.0

1 release file

2.0.3

2 release files

2.0.2

2 release files

2.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page