Timeline¶
Viewing your home timeline¶
By default the home timeline is fetched — statuses from accounts you follow and your own posts. A Rich table is printed with three columns: author/timestamp/ID, content (with content warning if set), and favourite/boost counts. Each status occupies its own row separated by a horizontal rule:
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━┓
┃ From ┃ Content ┃ ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━┩
│ @friend@example.com │ Just published my new blog post about Rust async │ ♥ 12 │
│ 2026-04-18 09:12 │ patterns. Hope you enjoy it! │ ♺ 3 │
│ 109876543210987654 │ │ │
├──────────────────────────────┼───────────────────────────────────────────────────┼───────┤
│ @artist@fosstodon.org │ CW: eye contact │ ♥ 5 │
│ 2026-04-18 08:44 │ Portrait commission open — DMs welcome, booked │ ♺ 0 │
│ 123456789012345678 │ through end of May │ │
└──────────────────────────────┴───────────────────────────────────────────────────┴───────┘
The status ID shown in the third line of each row can be passed directly to taibai view:
Feed types¶
Pass a feed name as the first argument to select a different timeline.
Home (default)¶
Statuses from accounts you follow, plus your own posts. Requires authentication.
Public¶
The federated public timeline — statuses from all known users, not just those you follow.
Use --local to restrict to your instance only, or --remote for remote statuses only:
Hashtag¶
Statuses tagged with a specific hashtag. --tag is required.
List¶
Statuses from a user-defined list. --list-id is required. Use taibai lists (Milestone 5) to
find your list IDs.
Limiting results¶
Use --limit / -n to control how many statuses are returned (default: 20, server max: 40):
JSON output¶
Pass --json to dump all fetched statuses as a JSON array instead of the table. Only fields
that have a value are included. Useful for scripting or piping to jq:
taibai timeline --json
taibai timeline public --json | jq '.[0].id'
taibai timeline tag --tag python --json | jq '[.[] | .url]'
Options reference¶
| Option | Short | Env | Default | Description |
|---|---|---|---|---|
feed |
— | — | home |
Timeline feed: home, public, tag, or list |
--limit |
-n |
— | 20 |
Maximum number of statuses to fetch |
--tag |
— | — | — | Hashtag to display (required for tag feed) |
--list-id |
— | — | — | List ID to display (required for list feed) |
--local |
— | — | off | Restrict public timeline to local statuses |
--remote |
— | — | off | Restrict public timeline to remote statuses |
--json |
— | — | off | Dump statuses as JSON instead of a table |
--profile |
-p |
TAIBAI_PROFILE |
default |
Profile to use |