{"id":22573138,"url":"https://github.com/lallassu/gorss","last_synced_at":"2026-01-21T22:10:54.644Z","repository":{"id":39862280,"uuid":"209380442","full_name":"Lallassu/gorss","owner":"Lallassu","description":"Go Terminal Feed Reader","archived":false,"fork":false,"pushed_at":"2024-09-18T09:00:17.000Z","size":29372,"stargazers_count":443,"open_issues_count":10,"forks_count":32,"subscribers_count":12,"default_branch":"master","last_synced_at":"2025-04-02T04:03:46.910Z","etag":null,"topics":["atom","atom-feed","atom-reader","go","golang","gorss","opml","reader","rss","rss-feed","rss-reader"],"latest_commit_sha":null,"homepage":"","language":"Go","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/Lallassu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":"lallassu"}},"created_at":"2019-09-18T18:44:16.000Z","updated_at":"2025-03-17T17:02:35.000Z","dependencies_parsed_at":"2024-06-18T21:24:10.611Z","dependency_job_id":"5c0a0ec8-04c9-4088-ab1c-fca0390c55ac","html_url":"https://github.com/Lallassu/gorss","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lallassu%2Fgorss","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lallassu%2Fgorss/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lallassu%2Fgorss/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lallassu%2Fgorss/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Lallassu","download_url":"https://codeload.github.com/Lallassu/gorss/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247980837,"owners_count":21027808,"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","atom-feed","atom-reader","go","golang","gorss","opml","reader","rss","rss-feed","rss-reader"],"created_at":"2024-12-08T02:14:02.746Z","updated_at":"2026-01-21T22:10:54.637Z","avatar_url":"https://github.com/Lallassu.png","language":"Go","funding_links":["https://github.com/sponsors/lallassu"],"categories":[],"sub_categories":[],"readme":"# GORSS - Go RSS Reader\n[![Go Report Card](https://goreportcard.com/badge/github.com/lallassu/gorss#1)](https://goreportcard.com/report/github.com/lallassu/gorss)\n[![MIT License](http://img.shields.io/badge/license-MIT-blue.svg)](http://www.opensource.org/licenses/MIT)\n\n## About\nSimple RSS/Atom reader written in Golang. Highly configurable and with themes.\n\n![Overview](preview/gorss.gif)\n\n[Screenshots](#screenshots)\n\n\n## Usage\nTarballs with prebuilt binaries for both Linux and OSX can be found under release page.\n\nJust start by running either `gorss_linux` or `gorss_osx` binary from the tarballs.\n\nYou can also specify theme, configuration and database manually.\n```\n./gorss -config gorss.conf -theme default.theme -db mydb.db\n```\n\nIf either the configuration or theme files are not specified, gorss will attempt\nto use`$XDG_CONFIG_HOME/gorss/gorss.conf` and\n`$XDG_CONFIG_HOME/gorss/themes/default.theme`, respectively.  These files will be\ncreated from the defaults if not present.\n\nTo build and run use the makefile.\n```\nmake run\n```\n\nIn order to cross-compile `make release` for Linux on OSX you need to install the following:\n```\nbrew install FiloSottile/musl-cross/musl-cross\n```\n\nThe database `gorss.db` will be automatically created in your systems 'Data Home' directory. You can specify which database\nto use with the argument `-db` to the binary.\n\n## Features\n- OPML Support for loading feed URLs (`opmlFile` in gorss.conf)\n- Support for XDG configuration\n- RSS and Atom support (via github.com/mmcdole/gofeed)\n- Highlights for configurable words\n- Keyboard shortcuts highly configurable\n- Custom keys for custom execution of external applications\n- Open links in browser\n- Mark articles and open all marked in bulk in webbrowser\n- 8 Built-in themes with runtime theme switching (press `T` to cycle)\n- Preview content of the RSS\n- Backed by SQLite database\n- Mark articles as read\n- Mark all as read/unread\n- Undo last read (mark it as unread)\n- Search titles\n- System notifications\n\n## Configuration Example (Default config)\nIt's possible to specify configuration file as a flag, default is `gorss.conf`.\n\nThe configuration file can specify URLs of feeds as strings, or, if you want to\ncustomise the name of the feed as it is shown in your Gorss, as objects with url\nand name fields. (See the example below for supported options).\n```\n./gorss -config my.conf\n```\n\n```\n{\n    \"highlights\": [\n        \"emulation\",\n        \"truck\",\n        \"google\",\n        \"network\",\n        \"math\",\n        \"toyota\"\n    ],\n    \"OPMLFile\": \"../example_ompl.xml\",\n    \"feeds\": [\n        \"https://news.ycombinator.com/rss\",\n        {\"url\": \"https://www.sweclockers.com/feeds/nyheter\", \"name\": \"Swedish Overclocking\"},\n        {\"url\": \"https://www.reddit.com/r/homeassistant/.rss\", \"name\": \"Home Assistant\"},\n        {\"url\": \"https://www.reddit.com/r/golang/.rss\"},\n        {\"url\": \"https://www.reddit.com/r/programming/.rss\"}\n    ],\n    \"feedWindowSizeRatio\": 2,\n    \"articlePreviewWindowSizeRatio\": 5,\n    \"articleWindowSizeRatio\": 2,\n    \"previewWindowSizeRatio\": 1,\n    \"feedNameMaxWidth\": 20,\n    \"daysToKeepDeletedArticlesInDB\": 1,\n    \"daysToKeepReadArticlesInDB\": 1,\n    \"skipArticlesOlderThanDays\": 10,\n    \"secondsBetweenUpdates\": 300,\n    \"skipPreviewInTab\": true,\n    \"keyOpenLink\": \"Backspace2\",\n    \"keyMarkLink\": \"Enter\",\n    \"keyOpenMarked\": \"o\",\n    \"keyDeleteArticle\": \"d\",\n    \"keyMoveDown\": \"s\",\n    \"keyMoveUp\": \"w\",\n    \"keySortByDate\": \"r\",\n    \"keySortByUnread\": \"e\",\n    \"keySortByTitle\": \"t\",\n    \"keySortByFeed\": \"y\",\n    \"keyUpdateFeeds\": \"Ctrl+U\",\n    \"keyMarkAllRead\": \"Ctrl+R\",\n    \"keyMarkAllUnread\": \"Ctrl+T\",\n    \"keyMarkAllReadFeed\": \"Ctrl+F\",\n    \"keyMarkAllUnreadFeed\": \"Ctrl+G\",\n    \"keyTogglePreview\": \"q\",\n    \"keyToggleFeeds\": \"f\",\n    \"keyCycleTheme\": \"T\",\n    \"keySelectFeedWindow\": \"1\",\n    \"keySelectArticleWindow\": \"2\",\n    \"keySelectPreviewWindow\": \"3\",\n    \"keyToggleHelp\": \"h\",\n    \"keySwitchWindows\": \"Tab\",\n    \"keyQuit\": \"Esc\",\n    \"keyUndoLastRead\": \"u\",\n    \"keySearchPromt\": \"/\",\n    \"collapseFeeds\": false,\n    \"notifications\": true,\n    \"customCommands\": [\n        {\n            \"key\": \"j\",\n            \"Cmd\": \"echo 'ARTICLE.Content' 'ARTICLE.Link' \u003e /tmp/test2.txt\"\n        },\n        {\n            \"key\": \"k\",\n            \"Cmd\": \"echo 'ARTICLE.Title' 'ARTICLE.Feed' \u003e /tmp/test.txt\"\n        }\n    ]\n}\n```\n\n### New Configuration Options (v0.5+)\n\n- **`feedNameMaxWidth`** (int, default: 20): Maximum width for feed names in the articles view. Reduce this to give more space to article titles.\n- **`keyToggleFeeds`** (string, default: \"f\"): Toggle the visibility of the feeds panel for more reading space.\n- **`keyCycleTheme`** (string, default: \"T\"): Cycle through all available themes at runtime without restarting.\n- **`collapseFeeds`** (bool, default: false): Start with the feeds panel hidden.\n\n## Custom Commands\nCustom commands can be added such as the example in the example configuration above.\n\nThe variables given will be substituted with the content of the given article. There are no escaping going on\nso be careful!\n\nAvailable variables are:\n* `ARTICLE.Content` - The content of the article\n* `ARTICLE.Link` - The link to the article\n* `ARTICLE.Feed` - Name of the feed\n* `ARTICLE.Title` - Title of the article\n\n## Themes\nGorss includes 8 beautiful built-in themes that are embedded in the binary. You can cycle through themes at runtime by pressing `T` (or your configured `keyCycleTheme`), or start with a specific theme as an argument.\n\n### Available Built-in Themes\n- **default** - Vibrant teal and pink palette\n- **irssi** - Classic IRC client inspired theme\n- **night** - Dark theme for nighttime reading\n- **dracula** - Popular Dracula color scheme\n- **nord** - Arctic, north-bluish color palette\n- **gruvbox** - Retro groove warm colors\n- **monokai** - Sublime Text inspired theme\n- **tokyo-night** - Modern dark theme with purple accents\n\n```\n./gorss -theme dracula.theme\n```\n\nAll themes are embedded in the binary, but you can still create custom theme files. Themes are configured with JSON, default example below:\n```\n{\n    \"feedNames\": [\n        \"#8ed2c8\",\n        \"#46aa9f\",\n        \"#2e6294\",\n        \"#3b9293\"\n    ],\n    \"date\": \"#a25478\",\n    \"time\": \"#f96bad\",\n    \"articleBorder\": \"#4b7d81\",\n    \"previewBorder\": \"#4b7d81\",\n    \"feedBorder\": \"#4b7d81\",\n    \"feedBorderTitle\": \"#fcedd5\",\n    \"articleBorderTitle\": \"#fcedd5\",\n    \"previewBorderTitle\": \"#fcedd5\",\n    \"highlights\": \"#c90036\",\n    \"tableHead\": \"#b2b37d\",\n    \"title\": \"#fcedd5\",\n    \"unreadFeedName\": \"#FFFFFF\",\n    \"totalColumn\": \"#FFFFFF\",\n    \"unreadColumn\": \"#FFFFFF\",\n    \"previewText\": \"#FFFFFF\",\n    \"previewLink\": \"#39537e\",\n    \"statusBackground\": \"#4b7d81\",\n    \"statusText\": \"#fcedd5\",\n    \"statusKey\": \"#f6d270\",\n    \"statusBrackets\": \"#bfceab\",\n    \"feedIcon\": \"🔖\",\n    \"articleIcon\": \"🗞\",\n    \"previewIcon\": \"📰\",\n    \"linkMarker\": \"🌍\",\n    \"unreadMarker\": \"🌟\"\n}\n```\n\n## [Screenshots]\n![default theme](preview/default.png)\n![irssi theme](preview/irssi.png)\n![night theme](preview/night.png)\n\n## License\nThis is distributed under the [MIT License](http://www.opensource.org/licenses/MIT).\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flallassu%2Fgorss","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flallassu%2Fgorss","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flallassu%2Fgorss/lists"}