neiman/splinter
1
9
Fork 1
Code Issues 1 Pull requests Activity
Split long articles into Mastodon threads.
25 commits 1 branch 1 tag 631 KiB
Find a file
neiman 873e503119 Update the about page
2025-08-06 10:42:57 +02:00
public improve text splitting 2025-07-26 15:28:32 +02:00
src improve text splitting 2025-07-26 15:28:32 +02:00
views Update the about page 2025-08-06 10:42:57 +02:00
.env Release candidate 2025-05-04 10:25:37 +02:00
.gitignore Fix bug in mobile view of visibility dropdown menu slipping to the left in small mobile screens 2025-05-12 19:11:52 +02:00
.prettierrc Release candidate 2025-05-04 10:25:37 +02:00
config.js Release candidate 2025-05-04 10:25:37 +02:00
index.js Add date and time to logging 2025-08-05 10:33:08 +02:00
LICENSE.txt Clarifying license 2025-06-06 15:31:58 +02:00
package-lock.json Add an add a Force new post break button 2025-06-06 21:17:59 +02:00
package.json Clarifying license 2025-06-06 15:31:58 +02:00
README.md Release candidate 2025-05-04 10:25:37 +02:00

README.md

Splinter

Splinter is a tool for Mastodon threads. It turns long articles into Mastodon posts and publishes them for you automatically.

How Does Splinter Work?

Splinter divides your text into posts using a simple principle:

  • Don't break words or paragraphs in the middle.

The only exceptions are:

  • The paragraph is too long to fit in one post,
  • The paragraph is too short (to avoid super short posts),
  • Or, you wrote a really long word that can't fit (kudos!).

Manual Post Breaks

You can force a post break using a Magic Word "=====" (5 equal signs). Just insert a line like this:

=====

Splinter will split the thread at that point and start a new post.

Post Visibility

Post visibility controls who sees each post and where it appears.

Splinter supports Mastodon’s regular options (Public, Unlisted, Followers-only, and Direct).

It also adds a special option:

Thread — the first post is public, the rest are unlisted.
This avoids cluttering followers’ timelines. It’s Splinter’s default.

Compatibility with Other Fediverse Platforms

Will Splinter work with other ActivityPub platforms like Sharkey, Misskey, or Firefish?
Hopefully — but it hasn't been tested yet.

If you try it and it works, let me know!

Missing Features

Here are a few features I’d like to add in the future:

  • Replying to an existing post
  • Support for custom emojis
  • RTL language support (Arabic, Hebrew, etc.)

Contribution

The source code is available at (Codeberg)[https://codeberg.org/neiman/splinter].

Contributions are welcome! But please reach out first by email or Mastodon to coordinate — that way I can make sure your work fits the roadmap and gets included.

License

Splinter is released under the GPL license.

About the Author

Hi! I'm Neiman (nickname, not a real name!).
I studied math, but I’ve worked in p2p and applied cryptography for the past 9 years.

My dream is to build a democratic web.
In the meantime, I build fun tools and write about digital identity, democracy, and cryptography.

More at neimanslab.org.

Feel free to reach out via: