{"id":13752732,"url":"https://github.com/relikd/baRSS","last_synced_at":"2025-05-09T20:34:15.947Z","repository":{"id":50530754,"uuid":"150420968","full_name":"relikd/baRSS","owner":"relikd","description":"Menu Bar RSS reader for macOS","archived":false,"fork":false,"pushed_at":"2023-10-12T23:16:33.000Z","size":899,"stargazers_count":136,"open_issues_count":6,"forks_count":5,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-04-15T03:49:10.295Z","etag":null,"topics":["atom","feed","macos","menu-bar","rss","rss-reader"],"latest_commit_sha":null,"homepage":"","language":"Objective-C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/relikd.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-09-26T12:10:44.000Z","updated_at":"2025-04-04T19:04:36.000Z","dependencies_parsed_at":"2024-01-02T21:56:06.924Z","dependency_job_id":"476583b0-5667-43aa-8675-f288d69a8ccf","html_url":"https://github.com/relikd/baRSS","commit_stats":null,"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/relikd%2FbaRSS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/relikd%2FbaRSS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/relikd%2FbaRSS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/relikd%2FbaRSS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/relikd","download_url":"https://codeload.github.com/relikd/baRSS/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253321732,"owners_count":21890453,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["atom","feed","macos","menu-bar","rss","rss-reader"],"created_at":"2024-08-03T09:01:10.140Z","updated_at":"2025-05-09T20:34:12.359Z","avatar_url":"https://github.com/relikd.png","language":"Objective-C","readme":"[![macOS 10.12+](https://img.shields.io/badge/macOS-10.12+-888)](#download--install)\n[![Current release](https://img.shields.io/github/release/relikd/baRSS)](https://github.com/relikd/baRSS/releases)\n[![All downloads](https://img.shields.io/github/downloads/relikd/baRSS/total)](https://github.com/relikd/baRSS/releases)\n[![GitHub license](https://img.shields.io/github/license/relikd/baRSS)](LICENSE)\n\n\nbaRSS – *Menu Bar RSS Reader*\n=============================\n\n![screenshot](screenshot.png)\n\n\nWhat is it?\n-----------\n\nA RSS \u0026 Atom feed reader that lives in the system status bar.  \nVery much inspired by [RSS Menu](https://itunes.apple.com/us/app/rss-menu/id423069534); go ahead and check that out.\n\n*baRSS* will automatically update feeds for you, and inform you when new content is available.\nThe new articles are just a menu away.\n\n\n### Features\n\n*baRSS* is unobtrusive, fast, and built from scratch with minimal footprint in mind.\nThe application uses less than 30 Mb memory and has a ridiculous file size of 1 Mb.\n\nSpeaking of reducing web traffic.\nIn contrast to other applications, *baRSS* does not save any cached web sessions or cookies as a matter of fact.\nBut it will reuse `ETag` and `Last-Modified` headers to avoid unnecessary transmissions.\nFurther, tuning the update frequently will decrease the traffic even more.\n\n\n\nDownload \u0026 Install\n------------------\n\nRequires macOS Sierra (10.12) or higher.\n\n### Easy way\nGo to [releases](https://github.com/relikd/baRSS/releases) and downloaded the latest version.  \nSearching for the App Store release? Read this [notice](#app-store-notice).\n\n### Build from source\nYou'll need Xcode, [RSXML2] \\(required), and [QLOPML] \\(optional).\n\n```sh\ngit clone https://github.com/relikd/baRSS\ngit clone https://github.com/relikd/RSXML2\ngit clone https://github.com/relikd/QLOPML\n```\n\nAlternatively, you can simply delete the `QLOPML` project reference without much harm.\n`QLOPML` is a Quick Look plugin for `.opml` files.\nIt will display the file contents whenever you hit spacebar.\n\nThat's it. \nOpen `baRSS/baRSS.xcodeproj` and build the project. \nNote, there are some compiler flags that append 'beta' to the development release. \nIf you prefer the optimized release version go to `Product \u003e Archive`.\n\n\n\nHidden options\n--------------\n\n### Launch on start / reboot\n\nbaRSS has no option to launch it on start.\nHowever, you can still add the application to auto boot by adding it to the system login items:\n\n`System Preferences \u003e User \u003e Login Items`\n\n\n### CLI options\n\nThe following options have no UI equivalent and must be configured in Terminal. \nMost likely, you will never stumble upon these if not reading this chapter.\n**Note:** To reset an option run `defaults delete de.relikd.baRSS {KEY}`, where `{KEY}` is an option from below.\n\n\n1. If you hold down the option key and click on an article item, you can mark a single item (un-)read without opening it.\n\n2. When holding down the option key, the menu will show an item to open only a few unread items at a time. \nThis number can be changed with the following Terminal command (default: 10):\n```\ndefaults write de.relikd.baRSS openFewLinksLimit -int 10\n```\n\n3. In preferences you can choose to show 'Short article names'. \nThis will limit the number of displayed characters to 60 (default). \nWith this Terminal command you can customize this limit:\n```\ndefaults write de.relikd.baRSS shortArticleNamesLimit -int 50\n```\n\n4. Limit the number of displayed articles per feed menu.\n**Note:** displayed unread count may be different than the unread items inside. 'Open all unread' will open hidden items too.\n```\ndefaults write de.relikd.baRSS articlesInMenuLimit -int 40\n```\n\n5. You can change the appearance of colors throughout the application. \nE.g., The tint color of the menu bar icon and the color of the blue unread articles dot.\n```\ndefaults write de.relikd.baRSS colorStatusIconTint -string \"#37F\"\ndefaults write de.relikd.baRSS colorUnreadIndicator -string \"#FBA33A\"\n```\n\n6. To backup your list of subscribed feeds, here is a one-liner:\n```\nopen barss:backup \u0026\u0026 cp \"$HOME/Library/Containers/de.relikd.baRSS/Data/Library/Application Support/baRSS/backup/feeds_latest.opml\" \"$HOME/Desktop/baRSS_backup_$(date \"+%Y-%m-%d\").opml\"\n```\n\n\n\nToDo\n----\n\nThe following list is a collection of ideas that may be added if people request it.\n\n- [ ] Localizations\n- [ ] Feed generator for websites without feeds\n- [ ] Automatically choose best update interval (e.g., avg)\n- [ ] Sync with online services\n- [ ] Feeds with authentication\n- [ ] Notification Center\n- [ ] Distraction Mode\n\t- [ ] Distract less: Sleep timer. (e.g., disable updates during working hours)\n\t- [ ] Distract more: Automatically open feed items\n- [ ] Add support for media types\n\t- [ ] music / video? (open media player)\n\t- [ ] Pure image feed? (show images directly in menu)\n- [ ] Per feed / group settings\n\t- [ ] select launch application (e.g., for podcasts)\n\t- [ ] exclude unread count from menu bar (e.g., unimportant feeds)\n- [ ] ~~Infinite storage. (load more button)~~\n\n\n\nFAQ / Q\u0026A\n---------\n\n### App Store Notice\n\nIf you find this app somewhere on the App Store, you can be sure that it is a counterfeit.\nAs long as you can read this very notice, I am not responsible for the publication.\nFurther, I can't guarantee the App Store version wasn't modified by a malicious actor to spy on you.\n\n\n### Why create something that already existed?\n\nFirst, open source is awesome!\nSecond, RSS Menu made some design decisions I didn't like.\nFor example, the new integrated browser window.\n\nOne thing I liked most, was the fact that feeds were opened in the default browser.\nNot like 99% of the other feed readers on the market that show a separate HTML viewer window.\nNo rendering issues, no broken links, no content that is different from the actual news article.\n\nI know, the whole purpose of RSS is to deliver content without the need of opening a webpage.\nBut for me RSS is more about being informed whenever a blog or news feed has updated content.\nE.g, subscribing to video channels without having to have an account.\n\n\n### Why is this project not written in Swift?!\n\nActually, I started this project with Swift.\nEven without adding much functionality, the app was exceeding the 10 Mb file size.\nThe working alpha version, written in Objective-C, had only 500 Kb.\nThe reason being that Swift frameworks are always packed into the final application.\n\nSadly, this was before Swift 5 and ABI stability.\nHad I only started the project a year later…\nBut on the other hand, now it is macOS 10.12 compatible.\n\n### 3rd Party Libraries\n\nThis project uses a modified version of Brent Simmons' [RSXML] for feed parsing. \n[RSXML2] is licensed under a MIT license (same as this project).\n\n\n##### Trivia\n\n- Start of project: __July 19, 2018__\n- Estimated development time: __1970h+__\n- First prototype used __feedparser python__ library\n\n\n[QLOPML]: https://github.com/relikd/QLOPML\n[RSXML2]: https://github.com/relikd/RSXML2\n[RSXML]: https://github.com/brentsimmons/RSXML\n","funding_links":[],"categories":["News"],"sub_categories":["RSS"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frelikd%2FbaRSS","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frelikd%2FbaRSS","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frelikd%2FbaRSS/lists"}