Skip to main content

A command line application that lets you browse Reddit.

Project description


RedditCLI brings Reddit to the terminal, allowing you to do the following without leaving your command line:

  • Browse public subreddits, posts, comments, and users.
  • Iterate through comments and post indexes.
  • Search for posts, comments, and users.
  • Clear all the commands on the screen.


Pip Installation

The following command will install RedditCLI:

$ pip3 install redditcli

If you are not installing in a virtualenv, run with sudo:

$ sudo pip3 install redditcli

Once installed, run the RedditCLI auto-completer with interactive help:

$ reddit

Run commands:

$ rdt <command> [options] [args]

Auto-Completer and Interactive Help

You can enable fish-style completions and an auto-completion menu with interactive help:

$ reddit

If available, the auto-completer also automatically displays commands through a pager.

Within the auto-completer, the following syntax applies:

redditcli:$>> rdt <command> [options] [args]


  • rdt ls

  • Description: list posts front page and sorts by optional hot(default), new, rising, top, controversial.

    • Options:
      • --sort [hot|new|rising|top|controversial] - sort the list based on categories
      • --move [next|previous] - can only be used on result set
      • --subreddits - list all public subreddits available on reddit
      • --subreddits --move [next|previous] - can only be used on result set
  • view

  • Description: opens the permalink of the specified post index in a browser window.

    • Options:
      • --index [Integer Value] - can only be used on result set
      • --comments --index [Integer Value] - loads the comments of the specified post index. can only be used on result set
      • --more-comments --index [Integer Value] - Loads more comments from the post scope if there are posts to load.
  • search

  • Description: Searches reddit for the specified search term.

    • Options:
      • [Search Term]
      • ls --move [next|previous] - can only be used on result set
  • clear

    • Description: Clears the screen

Supported Python Versions

Python 3 and above.

Libraries Used

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

redditcli-2.1.0.tar.gz (5.8 kB view hashes)

Uploaded source

Built Distribution

redditcli-2.1.0-py3-none-any.whl (7.5 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page