Trending¶
Discover what's popular on your Mastodon instance right now: trending statuses, accounts, hashtags, or shared links.
Mastodon only
Trending endpoints are a Mastodon API feature. taibai will exit with a clear message if your instance does not support them (e.g. Pleroma, snac).
Basic usage¶
Without arguments, the command fetches trending statuses and displays them in a Rich table.
Feed types¶
Pass a feed name as the first argument to select what to show.
Statuses (default)¶
The most-shared, most-engaged posts trending on the instance right now.
Output is the same Rich table used by taibai timeline: author, content (with CW if set),
and favourite/boost counts.
Accounts¶
Accounts that are gaining followers or visibility on the instance.
Output: a table with handle, display name, and follower count.
Tags¶
Hashtags trending in recent posts.
Output: a table with #hashtag and the tag's page URL.
Links¶
News articles and URLs being widely shared across the instance.
Output: a table with title, URL, and a short description.
Limiting results¶
Use --limit / -n to control how many items are returned (default: 20):
JSON output¶
Pass --json to dump the raw results as a JSON array instead of a table. Only fields
with values are included. Useful for scripting or piping to jq:
taibai trending --json
taibai trending tags --json | jq '.[].name'
taibai trending links --json | jq '.[].url'
Options reference¶
| Option | Short | Env | Default | Description |
|---|---|---|---|---|
feed |
— | — | statuses |
Feed: statuses, accounts, tags, or links |
--limit |
-n |
— | 20 |
Maximum number of items to fetch |
--json |
— | — | off | Dump results as JSON instead of a table |
--profile |
-p |
TAIBAI_PROFILE |
default |
Profile to use |