Getting Noodle Magxine Running Without Losing Your Mind
I've been using Noodle Magxine for about two years now, first because I needed something lighter than the usual news aggregators and later because my workflow around it started to settle into something functional. It pulls content from feeds, applies its own ranking layer, and surfaces pieces without all the usual engagement-bait formatting. The basic idea is straightforward enough, but the setup has a few rough edges that aren't documented well anywhere. The product itself is a feed-processing engine with a lightweight browser layer. It reads RSS, Atom, and certain JSON-based sources, runs them through a relevance filter, and serves up a clean timeline. That's the core. What most people miss at first is that the relevance filter is completely configurable through a config file you edit directly. The default settings are fine for casual reading, but if you want actual control, you need to tweak the weighting parameters yourself. The download comes from their main site, noodlemagxine.com, and they offer an installer for Windows, a package for macOS, and a snap for Ubuntu. The Linux version is the most stable by far. The Windows build still occasionally drops feed items after a background refresh cycle. Nothing catastrophic, but noticeable if you're watching the log.
I ended up going through the config file because the default ranking was burying several sources I actually cared about. The file lives at ~/.config/noodle-magxine/config.json on Linux and %APPDATA%\NoodleMagxine\config.json on Windows. The relevant section is under "weighting". Each source gets a base score, and there's also a recency multiplier and a topic override. The trick is that topic overrides are case-sensitive and don't accept wildcards the way you'd expect. Here's a practical example from my own setup. I wanted tech news from a few specific outlets to always appear above general business feeds, but the default behavior kept mixing in sponsored content from the same outlets. I set the priority_weight to 0.8 for those sources and dropped the sponsored_boost to zero. After that, the timeline cleaned up almost immediately. The process took about ten minutes and I found the right fields by reading through the comments inside the config file itself, which most people skip. The built-in search is another area where the documentation is weak. It supports simple boolean operators, but AND and OR need to be uppercase. Lowercase operators get ignored and the query just runs as a plain text match. I spent an afternoon debugging a search that seemed to return random results before I realized the operator casing was the problem. Once I fixed that, searches like algorithm AND policy OR regulation worked exactly as expected.
One thing the official docs don't mention is that Noodle Magxine caches feeds locally in a SQLite database. The cache lives in ~/.local/share/noodle-magxine/cache/. If your disk space is tight or you're working on a machine with heavy I/O throttling, clearing that cache periodically prevents slowdowns. A simple VACUUM; command through the sqlite CLI is enough to reclaim space. I run this maybe once a month depending on how many feeds I'm tracking. There's also a plugin system that's mostly undocumented. The plugins sit in a plugins/ directory and are just Python scripts that hook into the feed processing pipeline. You can write a custom filter that strips tracking parameters, blocks certain domains, or even pulls content from sources that don't publish standard feeds. I wrote a small plugin that extracts article text from pages where the RSS feed only includes excerpts instead of full content. It cut my daily reading time significantly because I stopped having to open half the articles in a separate browser tab. The mobile companion app exists but it's fairly limited compared to the desktop version. It syncs your subscriptions and cache, but the configuration has to be done on desktop. If you're primarily reading on a phone, you'll still need to make most adjustments through the desktop client and let it sync over. The sync itself uses a lightweight protocol over port 8443. Make sure your firewall allows that, or your mobile device will show stale feeds indefinitely.
Get the Full Details

Performance on the desktop app is generally good. Feed refresh cycles are configurable, and the default interval of five minutes is reasonable for most people. If you're tracking a very high volume of feeds, setting it to three minutes helps, but you'll use more resources. The app does use Electron, so it sits somewhere around 400 to 600 megabytes of RAM depending on how many feeds you have open. Not ideal for older machines, but manageable on anything from the last five years or so. For people who want to move away from Noodle Magxine, exporting your subscriptions is straightforward. Go to Settings > Data Export and you can pull out a JSON file with all your sources, filters, and saved articles. Import into another reader is easy if that reader supports standard OPML or RSS imports. I did this once when I was testing a competitor and came back. Took about fifteen minutes end to end. There are some genuine limitations worth knowing before you invest time in this. The feed parser doesn't handle malformed XML gracefully. A single stray character in an RSS feed can cause the entire source to be skipped during refresh. You'll see it marked as failed in the status column, and the error logs will point you to the exact line. Fixing it usually means editing the feed URL or skipping that source entirely. There's also no built-in social sharing within the app itself. If you want to send an article to a colleague, you copy the link and paste it elsewhere.
Another issue is that the recommendation engine is fairly blunt. It learns from your reads and hides items you've already seen, but it doesn't do anything sophisticated like sentiment analysis or reading depth scoring. It mainly tracks which sources and topics you engage with most frequently and adjusts the weighting accordingly. That's fine for most users, but if you're looking for nuanced editorial curation, you won't find it here. If you're on a strict budget and want something closer to a raw RSS reader with no ranking layer at all, Newsboat is a solid alternative. It runs in the terminal, uses negligible resources, and handles malformed feeds better than Noodle Magxine does. The tradeoff is that it's command-line only and lacks the polished interface. If you need visual browsing and don't mind a heavier app, Noodle Magxine is worth the setup effort. The install itself is under five minutes on Linux, about eight on Windows if you go with the installer. macOS varies depending on whether you're dealing with Gatekeeper prompts. After installation, I'd recommend immediately editing the config file to set your source priorities, adding the plugin directory if you plan to write custom filters, and running your first refresh cycle. Check the logs for any failed sources and decide whether to fix or drop them. From there, it's just a matter of adjusting the refresh interval and building a habit around checking the timeline rather than hopping between twenty different sites.
The app is still being actively developed, so new features roll in every couple of months. The changelog is on their GitHub page, but most of the useful details end up in the config file comments and the plugin examples, not in official blog posts. If you're comfortable reading source code or tweaking JSON directly, this tool pays off. If you prefer a fully guided setup with no hands-on configuration, you might find the friction frustrating.
