Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ltguillaume/feedmei
A clean and minimal theme for Tiny Tiny RSS, loosely inspired by Feedly. This repo also contains some plugins to improve navigation and an update script.
https://github.com/ltguillaume/feedmei
keyboard-shortcuts minimal-theme night-mode plugins theme tiny-tiny-rss tiny-tiny-rss-theme tinytinyrss tt-rss ttrss update-script
Last synced: 3 days ago
JSON representation
A clean and minimal theme for Tiny Tiny RSS, loosely inspired by Feedly. This repo also contains some plugins to improve navigation and an update script.
- Host: GitHub
- URL: https://github.com/ltguillaume/feedmei
- Owner: ltguillaume
- License: agpl-3.0
- Created: 2019-02-21T20:25:33.000Z (almost 6 years ago)
- Default Branch: main
- Last Pushed: 2024-11-29T20:48:15.000Z (24 days ago)
- Last Synced: 2024-12-13T02:51:36.655Z (10 days ago)
- Topics: keyboard-shortcuts, minimal-theme, night-mode, plugins, theme, tiny-tiny-rss, tiny-tiny-rss-theme, tinytinyrss, tt-rss, ttrss, update-script
- Language: CSS
- Homepage: https://codeberg.org/ltguillaume/wikimuch
- Size: 927 KB
- Stars: 83
- Watchers: 10
- Forks: 6
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# FeedMei Theme + Plugins for Tiny Tiny RSS
by ltGuillaume: [Codeberg](https://codeberg.org/ltGuillaume) | [GitHub](https://github.com/ltGuillaume) | [Buy me a beer](https://buymeacoff.ee/ltGuillaume) 🍺
A clean and minimal theme for [Tiny Tiny RSS](https://tt-rss.org), loosely inspired by Feedly. Built by making the minimal amount of changes to the default theme.
This repo also includes a set of plugins ([see details](plugins.local/)). Finally, there's an [update & cleanup script](update_tt-rss.php) to easily update your Tiny Tiny RSS instance to the latest commit.
## FeedMei+
FeedMei+ (`feedmei+.css`) adds a few other tweaks:
- Use the font _PT Serif_ for article contents
- To optimize legibility, set a maximum width for the article contents
- Increase the font size for article headers
- Reduce the size of the first article image and align it to the right
- ~~Enable smooth scrolling~~ (since this interferes with the option `Mark read on scroll`, it's been disabled)
## Installation
_This theme can only be used in Tiny Tiny RSS v19.2 or later. FeedMei v2.1.8+ only works on commit [4ab3854aed](https://dev.tt-rss.org/tt-rss/tt-rss/commit/4ab3854aede3882779138d91594b588e1a38c70e) or later._
Just copy the contents of `themes.local` to the `themes.local` folder of your Tiny Tiny RSS installation. You can also copy `plugins.local` to your installation for additional functionality (see [README.md](plugins.local/)).
## Customization Tips
### Toggle night mode
If you want to use the menu option "Toggle night mode" for this (or any other custom) theme, instead of just the default theme, be sure to copy over `plugins.local/toggle_night_mode` and enable it in the plugin preferences. This plugin checks if the active custom theme has a `themes.local/[theme]_night.css` variant and enables/disables it. If there's no such file, the plugin will revert to the default behavior (and use the default theme to toggle night mode).
### Maximum width for articles
For optimal reading, the article shouldn't stretch out too far. Add this to `feedmei.css`, or use `feedmei+.css`, which includes more of my personal preferences:
```
div.cdm.expanded {
width: calc(100% - 72px);
max-width: 960px;
margin: 21px auto;
}
.content {
max-width: 50em;
margin: 0 auto;
}
```
### Align article top
In combined mode, put some space between the article and the header when jumping to previous/next article with hotkeys. In `rss/js/Article.js` replace:
```
ctr.scrollTop = row.offsetTop
```
with
```
ctr.scrollTop = row.offsetTop - (App.getInitParam("cdm_expanded") ? 18 : 0)
```