Skip to main content

An unofficial cli client for Reddit, aimed at people who regularly browse specific subreddits or topics instead of reading the homepage (r/all).

Project description

creddit - A CLI client for Reddit

An unofficial cli client for Reddit, aimed at people who regularly browse specific subreddits or topics instead of reading the homepage (r/all).

Features:

  • Distraction free. Can browse a few posts and continue with your day. No flashy gifs, awards, ads or posts.

  • Browse a subreddit by entering just the name.

  • Prints a link to the article mentioned in every post, for you to continue reading it in your browser (ctrl+click), in case you are interested.

  • Can browse top comments for every post just by entering the number shown beside the post in the terminal.

Feel free to send a PR with any additional features, or make an issue if you have any feature requests!

This source code is licensed under the MIT license found in the LICENSE file in the root directory of this source tree.

How to use?

Clone the repo and install the thing as a package

git clone --depth 1 https://github.com/vishalnandagopal/creddit/ creddit
cd creddit
pip install uv
uv sync
uv build
pip install ./dist/creddit-1.0.0-py3-none-any.whl

And to finally run it,

python -m creddit

Features to add

  • Publish to pip
  • More guidance on MPV, and alternatives if it isn't installed

(Copyright (c) 2025 Vishal N)

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

creddit-0.0.2.tar.gz (9.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

creddit-0.0.2-py3-none-any.whl (10.4 kB view details)

Uploaded Python 3

File details

Details for the file creddit-0.0.2.tar.gz.

File metadata

  • Download URL: creddit-0.0.2.tar.gz
  • Upload date:
  • Size: 9.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for creddit-0.0.2.tar.gz
Algorithm Hash digest
SHA256 f1505e49640764fa68318adba590f5eb583029c73184905101d05ed26136e691
MD5 3e9cb43ed08162dee8a3dc851f143449
BLAKE2b-256 a222c2b8d46e9fb336cd7c07fd5c9decac4fc07452e5f4545736ab3501369604

See more details on using hashes here.

Provenance

The following attestation bundles were made for creddit-0.0.2.tar.gz:

Publisher: publish-pypi.yml on vishalnandagopal/creddit

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file creddit-0.0.2-py3-none-any.whl.

File metadata

  • Download URL: creddit-0.0.2-py3-none-any.whl
  • Upload date:
  • Size: 10.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for creddit-0.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 b33edf9223d004d6421e7c1a8608e174757e0394be97f61e0e68830f5e01b3e9
MD5 25e072231d4a45eedd77308534b1d3b0
BLAKE2b-256 08d33f00b78fe7e7e2657e57eaeb167172f0627fe403f91d063718728143d494

See more details on using hashes here.

Provenance

The following attestation bundles were made for creddit-0.0.2-py3-none-any.whl:

Publisher: publish-pypi.yml on vishalnandagopal/creddit

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

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