Articlay

Default Article Count

Number of articles to load initially per tab: Save

Add New Source

Source Name: Category: India Tamil Nadu Movie Literature Writing Reddit Code & Tech Art & Culture Others Add Source 🎲 Surprise Me

Manage Sources

Custom sources added manually:

📦 Installation

Install Articlay command-line tool using pip:

pip install articlay

✨ Zero Configuration Required! Works immediately after installation.

🚀 Quick Start (No Setup Needed!)

After installation, just run Articlay from your terminal - no configuration required:

# Install and use immediately - that's it!
pip install articlay
articlay --all

✨ Works out of the box with no Gist ID or configuration needed!

✨ Features

• 📰 Category Filters: View articles by specific categories

  articlay --india        # India news
  articlay --tamilnadu    # Tamil Nadu news
  articlay --movie        # Movie articles
  articlay --tech         # Technology articles

• 🎲 Random Article: Get one random article

  articlay random

• 🔢 Control Limit: Choose how many articles to display

  articlay --india --limit 10    # Show 10 articles
  articlay --all --limit 0       # Show ALL articles

• 📚 All Categories Available: For You, India, Tamil Nadu, Movie, Literature, Writing, Reddit, Code & Tech, Art & Culture, Others

📖 Examples

# Show For You articles (default)
articlay

# Show 10 India news articles
articlay --india --limit 10

# Get one random article
articlay random

# Show all Tamil Nadu articles
articlay --tamilnadu --limit 0

# Show 15 tech articles
articlay --tech -l 15

# Show first 50 articles from all categories
articlay --all --limit 50

🔧 Advanced Configuration (Optional)

⚠️ Configuration is NOT required for normal use! The CLI works immediately after installation.

Only needed if you want to use your own private Gist or override the default:

# Optional: Use your own Gist ID
export ARTICLAY_GIST_ID=your_gist_id_here
articlay

# Optional: For private Gists
export GITHUB_TOKEN=your_token_here
articlay

📚 Full Documentation

For complete CLI documentation, see the CLI Guide on GitHub

🌟 Why Use the CLI?

• ✨ Zero configuration - works immediately!
• ⚡ Fast and lightweight
• 🎯 Filter by category instantly
• 🎲 Discover random articles
• 📱 Works in any terminal
• 🔄 Same content as web UI
• 💾 No setup, no config files needed