nebulapicker

nebulapicker v1.0.0

🚀 Stay informed without drowning in noise.

NebulaPicker is a self-hosted RSS feed generator that filters and refines content from multiple trusted sources to produce clean, personalized feeds tailored to your interests.

It aggregates entries from external RSS feeds, applies user-defined filtering rules, and publishes a curated output that can be consumed by any RSS reader or integrated into automated workflows.

✨ Features

• Automatically fetches content from multiple RSS sources using CRON jobs
• Custom filtering rules to remove unwanted noise
• Generates clean, focused RSS feeds
• Fully self-hosted — complete control over data and infrastructure

📦 Available Editions

Original Edition — lightweight RSS generator aggregating and filtering external sources

Content Extractor Edition — integrates with Wallabag to archive and read full articles.

🎬 Demo

Original Edition:

Content Extractor Edition:

🚀 Quick Start (Docker Compose)

NebulaPicker can be started without local setup using Docker Compose.

▶️ Original Edition

Runs the API, database, and web interface:

docker-compose up -d

Default credentials:

• username: nebulapicker
• password: nebulapicker

You can change them in the .env file.

Stop the application:

docker-compose down

📰 Content Extractor Edition

Includes Wallabag integration for full article extraction.

Start the stack:

docker-compose -f docker-compose-with-extractor.yaml up -d

Configure Wallabag:

1. Open http://localhost:8081
2. Login with:
   • username: wallabag
   • password: wallabag
3. Go to My Account → API Clients Management
4. Create a client and copy:
   • Client ID
   • Client Secret
5. Add them to .env.with_extractor:
   • WALLABAG_CLIENT_ID=
   • WALLABAG_CLIENT_SECRET=

Restart the stack:

docker-compose -f docker-compose-with-extractor.yaml up -d

Default NebulaPicker credentials remain:

• username: nebulapicker
• password: nebulapicker

Finally, to stop the stack:

docker-compose -f docker-compose-with-extractor.yaml down

🤝 Contributing

Contributions are welcome! Feel free to open issues or pull requests — see the contributing guide for details.