LinuxCommandLibrary

tuir

Browse and use Reddit from the terminal

TLDR

Launch tuir

$ tuir
copy

Open a subreddit
$ </>[subreddit_name]
copy

Open a link
$ <o>
copy

Open a specific subreddit on launch
$ tuir -s [subreddit_name]
copy

Open external links using programs defined in the mailcap config
$ tuir --enable-media
copy

SYNOPSIS

tuir [options]

PARAMETERS

-c, --config
    Specify a custom configuration file path.

-h, --help
    Show help message and exit.

-v, --version
    Show program's version number and exit.

-l, --log-level
    Set the logging level (DEBUG, INFO, WARNING, ERROR, CRITICAL).

-s, --clear-cache
    Clear the application cache.

-u, --update-cache
    Update the application cache.

DESCRIPTION

tuir is a terminal-based Reddit client written in Python.
It provides a curses-based interface for browsing and interacting with Reddit, allowing users to view posts, read comments, vote, and submit new content directly from their terminal.

tuir aims to offer a lightweight and efficient alternative to the official Reddit website and other graphical Reddit clients, particularly for users who prefer using the command line or have limited system resources.
It emphasizes keyboard navigation and customizable settings to cater to individual user preferences.
While not as feature-rich as some GUI clients, tuir provides a solid core experience for browsing and engaging with Reddit communities.

CAVEATS

tuir depends on external libraries like praw (Python Reddit API Wrapper). API changes on the Reddit side might break functionality.
Features may be limited compared to the official Reddit website or other GUI clients.

NAVIGATION

tuir uses keys j and k for moving down and up posts list. h and l for comments.
Pressing o to open the selected post link in web browser.

HISTORY

tuir was developed as an alternative interface to interact with Reddit using terminal.
The goal was to give lightweight, keyboard driven interface to browse Reddit subreddits.

SEE ALSO

curl(1), wget(1)

Copied to clipboard