## Feedbro - Help

### Keyboard Shortcuts

j/k or shift-rightarrow/leftarrow | item down/up | selects the next/previous item in the list
space/shift-space | page down/up | moves the page down/up
n/p | scan down/up | in list view, selects the next item without opening it
shift-n/p or shift-down/up | navigation down/up | selects the next/previous subscription or folder in the navigation
shift-x | navigation expand/collapse | expands or collapses a folder selected in the navigation
o | open/close item | in list view, expands or collapses the selected item
enter | open/close item | in list view, expands or collapses the selected item
shift-o or shift-enter | navigation open subscription | opens the subscription or folder currently selected in the navigation
m | mark as read/unread | switches the read status of the selected item
shift-a | mark all as read | marks all items in the current view as read
d or delete-key | delete item | marks active item as deleted
shift-d | delete loaded articles | deletes all articles in currently loaded view
s | toggle star | stars or un-stars the selected item
u | toggle show only unread | selects or deselects 'show only unread' setting
v | view original | opens the original source for this article in a new window
r | refresh | reloads currently selected feed/folder view from the local database
1 | expanded view | displays the subscription as expanded items
2 | list view | displays the subscription as a list of headlines
3 | titles view | left: feed navigator, center: list of feed titles, right: selected article
4 | news view | left: feed navigator, right: several articles with title, summary and image
5 | magazine view | left: feed navigator, right: several articles with title, summary and main image
k | previous item | in titles view selects the previous item on the list
j | next item | in titles view selects the next item on the list
w | hide/show feed tree | hides or shows the left navigator with the feed tree
e | send article link via email | opens your email client for sending the active article link
l | save to Pocket | saves the currently active article to Pocket without popups
t | add a tag | activates the "add tag" input field of the active article
alt-[n] | add a predefined tag | adds a predefined tag to the active article (defined in Options)
ctrl + | make UI text larger | increases font size in the entire UI a bit
ctrl - | make UI text smaller | decreases font size in the entire UI a bit

### Service Plugins

Feedbro provides built-in support for several popular services like YouTube Channels, YouTube Search, Instagram, Facebook, Twitter, VK.com, Yammer, Vimeo, Bitchute, SlideShare, Reddit, Pinterest, Rumble, Telegram, LinkedIn Groups, LinkedIn Home Feed and LinkedIn Job Search.
Just navigate to a page in such a service, click Feedbro WebExtension icon and then choose "Find Feeds in Current Tab" to see if the page is supported.

### Create Rules to Filter and Manage Articles

Under "Rules" menu you can define custom Rules that are trigged either when a new article arrives or when an article is viewed. Rule can e.g. highlight the article border, add a tag, highlight specific words, display a desktop notification, play a sound, trigger IFTTT action, hide or delete the article.

### Sort Articles by Points

In Feedbro you can sort articles by date (newest first, oldest first) or by points (most points first, if articles have equal points, newest first). This can be adjusted using the select box in the Feedbro toolbar.
To assign points to articles, you need to create a Rule (or several) under Rules menu. Define conditions based on which points should be added and then add action "Add Points" with number as parameter (e.g. 1). The power of this feature is that it allows you to raise or "bubble up" important articles or feeds. For example if you are following 100 YouTube channels with Feedbro, some of them might be more important than others. By creating rules that give more points to certain channel feeds than others, you can get them listed in priority order.

### Convert Partial Articles in Feeds to Full-Text Articles

Feedbro has built-in engine for transforming partial text feed articles to full-text articles. This feature is not automatically on for all feeds and must be enabled per feed. To do that, right-click the feed in the feed tree and select Properties. Then use "Feed Entry Content" for adjusting full text extraction settings. Click "Preview" button to check that you get desired results and then press "Save".
Note that obviously full-text option should not be used if the feed already provides full articles. Also the full-text conversion doesn't work for all feeds and sites but it works pretty well for majority of sites.

### Useful 3rd Party Services

kill-the-newsletter.com
  kill-the-newsletter.com lets you convert emails coming from a specific email distribution list to a feed that you can subscribe to with Feedbro.
google.com/alerts
  Google Alerts will help you to monitor almost the entire web for content that matches your search criteria and provides a feed that you can subscribe to with Feedbro.
IFTTT.com
  IFTTT (If This Then That) service will let you trigger different kind of actions (like sending an email or SMS) when your Feedbro rule matches. Choose IFTTT in the Feedbro rule as an action and use a proper IFTTT Maker channel channel URL (e.g. https://maker.ifttt.com/trigger/MYEVENT/with/key/AC11cggLDrvAWSZubQk7pn) as a parameter (replace MYEVENT with the name of your event and the key with your key-string provided by IFTTT).
mailnesia.com
  Mailnesia provides a free zero-setup disposable email address with RSS feed support.

### Setup IFTTT Email Notification Action

1. Open ifttt.com and login
2. Create a New Applet at https://ifttt.com/create
3. Click "+this"
4. Search for "WebHooks"
5. Click "Receive a web request" at "Choose a trigger" screen
6. Enter Feedbro when asked for Event Name
7. Click "+that"
8. Choose the action you want (e.g. Email)
9. Click "Send me an email" at "Choose action" screen
10. Modify the email template if needed and click "Save". Value1 = Feed Entry Link, Value2 = Feed Entry Title, Value3 = Feed Entry Author
11. Open https://ifttt.com/services/maker_webhooks/settings and open the URL mentioned on the page.
12. From the new page you can copy the actual Maker channel URL of form: https://maker.ifttt.com/trigger/Feedbro/with/key/a1BYTM78EZcjzB1zjpQi8X
13. Create or Edit a Rule in Feedbro
14. Add a new "IFTTT Maker Channel POST URL" action and enter the Maker channel URL as a parameter to the text field
15. Save the Rule

### Setup Discord channel Rule action

When creating a Rule, choose action "Discord HTTP POST URL".
With this action you can send the article title and its link to a Discord channel that you can also monitor with your mobile phone in real time. The argument is the Webhook URL that you can get from Discord UI when you click the small "cog" icon on the right side of the channel name (with "Edit Channel" tooltip), click "Webhooks" and then "Create Webhook" button. Name the Webhook e.g. "Feedbro" and then copy the Webhook URL and save the Webhook. Then paste the URL to Feedbro rule action parameter field.
The URL looks something like this:
https://discordapp.com/api/webhooks/123496711234906261/1234iIIimYkjIvG2gSvgyJkE7wX_YEdvWjJVggWwMMiR6Qr14viwDvy3XxII9raLQFsD

### Setup Slack channel Rule action

When creating a Rule, choose action "Slack HTTP POST URL".
With this action you can send the article title and its link directly to a Slack channel. The argument is the Webhook URL that you can get from Slack UI when adding a Webhook app.
The URL looks something like this:
https://hooks.slack.com/services/1234YVBJ69H/1234XC28CGM/123YqU28765XZnTtCQ22KVB

### Misc Tips and Tricks

- Feeds and Folders in the navigation tree can be arranged by drag & drop.
- Right-click any feed or folder to rename, delete or mark feed items as read. Feed properties can be also changed.
- You can easily remove 'dead' feeds in "Feed Statistics" view.
- Click 'Show only unread articles' icon to view fresh articles that you haven't seen before.
- Select proper value for 'Article max age' to show only fresh enough articles.
- Select 'list view' (shortcut '2') to just view a list of feed entry titles - useful for quick skimming.
- Click article top or bottom in list view to expand/close the article.
- Define rules to filter/highlight/hide/delete etc. feed articles automatically!
- Drag & drop Feedbro URL to the bookmarks bar and enable starting in 'All Items' view in Options to enable one-click access to latest articles.
- If you are using Linux, install Roboto font to get a nice looking UI (sudo apt-get install fonts-roboto)
- To get a clean reading view, hide the navigator (shortcut 'w') and use full screen mode (F11)

### Frequently Asked Questions

Help! Firefox doesn't load any articles!
  Your Firefox profile is most likely corrupted. When this happens, IndexedDB API stops working which breaks Feedbro. You can test your IndexedDB API functionality with this tool. If IndexedDB is indeed broken, open about:support and click "Refresh Firefox". WARNING! This will remove all your add-ons and their settings so backup your data first!
Help! I have some other technical problem!
  Please check this list for known issues. If you can't find an answer there, please contact us at feedbro.reader@gmail.com
How can I view just the unread articles?
  Enable "Show only unread" mode by either clicking the star+letter icon in the toolbar or press 'u' and then reload the view (click the feed in the tree or press 'r').
How can I view an article within Feedbro when using view mode 2, 4 or 5?
  Don't click the article title. Instead, click elsewhere in the article area to expand the content within Feedbro.
How can I get a desktop notification of new articles?
  To get a desktop notification when a new article arrives, you need to create a new Rule under Rules menu. Select "Desktop notification" as the action.
How can I get an email notification of new articles?
  First create a webhook with IFTTT.com Maker channel so that you get an URL that can be used to trigger email sending. Then create a Rule in Feedbro that has IFTTT Maker channel action and that URL as the parameter.
How can I save more than 100 articles per feed?
  Right-click the feed in the feed tree and select Properties. You can then adjust the "Maximum articles to save" to even 2000. Then click "Save". Note that initially most XML feeds provide only the latest 10-20 articles. So you can't typically get all articles from the past when you add the feed. Only the latest ones.
How can I get Reddit feeds to work?
  You must disable tracker protection for Reddit since Firefox blocks all XMLHttpRequests to Reddit by default.
  First open reddit.com and then click the small shield icon on the left side of the URL bar. Then use the slider to disable "Enhanced Tracking Protection is ON for this site". See this image.
  If that doesn't work, open about:preferences#privacy and choose "Custom" under "Enhanced Tracking Protection" and pick "Only in Private Windows" for the "Tracking content" selection box.
How can I get shorter update interval for my feed?
  Right-click the feed in the feed tree, select Properties and then adjust the "Scan Interval" setting. It can be as low as 1 minute.
How can I import my bookmarks from Firefox or Chrome?
  Open Options page and use "Import Firefox Bookmarks (as OPML)" button.
How can I preview a feed?
  Click the Feedbro extension icon and choose "Find Feeds in Current Tab". Then click the blue eye icon to preview the selected feed.
How can I get full articles for a feed instead of partial articles?
  Right-click the feed in the feed tree, select Properties and then use "Feed Entry Content" setting. Select either "Full article body" or "Full article body with article main image" and click "Preview" to check that you get articles properly. Then click "Save". Note that this will only affect the new articles that will be loaded after you have chosen this setting. In other words already loaded articles are not affected.
How can I reload all feeds manually?
  To reload all feeds you have manually, click the blue reload icon in the top left-hand corner in the Feedbro toolbar. To reload all feeds under a specific folder, right-click the folder and select "Update Feeds in Folder"
How can I sort articles by author?
  This is not directly possible. However, it is likely that you want to follow/sort articles by just certain selected people and not everyone. You can create a Rule under Rules menu which assigns a certain tag if the author of the article is one of the persons you want to follow. If you want, you can create a new tag per author.
How can I get notified of any new articles on the Internet that match my search?
  You can use Google Alerts to create a custom search that generates an RSS feed. Then subscribe to that in Feedbro.
How can I delete a feed?
  Right-click the feed in the feed tree and select "Delete".
How can I create subfolders?
  To keep things simple, Feedbro does not support subfolders.
Where can I find sound effects for Rules?
  There are several sites that host free sound effects on the Internet. One of them is freesound.org. You can get the sound clip URL if you open Development Console and Network view and filter by media before you click play on the site.
Does Feedbro have a search function?
  Currently Feedbro does not support full-text search. The reason is that HTML5 IndexedDB engine does not support it natively and while it would be possible to implement full-text search as a layer, it would have significant impact on performance. It's also quite challenging to write language stemmers for different languages.
  However, you can use Rules to assign tags to articles. Tags can be then accessed via the Tags menu and by clicking a Tag you can instantly find articles with that Tag.
How can I translate Feedbro UI to another language?
  Currently Feedbro supports English and Finnish out-of-the-box. You can choose the language in Options. You can also download the locale template and create a new translation (remember to edit the meta data as well). Then upload the translated file to e.g. github and import the translated locale to Feedbro. This way you can translate Feedbro to any language you want (except the Help file). And when people put locale files online and share the links, it benefits everyone. If you want to have your translated locale file included in Feedbro, please contact us at feedbro.reader@gmail.com
  If you host the locale on github, please update the meta-data in the JSON to include your data in "locale_author_email" and "locale_author_name" and ensure that "locale_source_url" points to the actual JSON file (URL starts with https://raw.githubusercontent.com/). You also need to provide the "raw" URL when importing the locale.
How can I download YouTube subscriptions as OPML?
  Use this link to download your subscriptions (login to YouTube first): https://www.youtube.com/subscription_manager?action_takeout=1
  You can export your YouTube subscriptions on this page as JSON.
Why don't you use chrome.storage.sync / Firefox sync for synchronizing feed subscription and feed entry data?
  Unfortunately chrome.storage.sync API that Firefox also uses has very strict limitations regarding the amount of data you can store. It also throttles the number of API requests per hour. That API does not provide enough space even for storing the feed subscription data and certainly cannot be used for handling feed entry data.
Why do select boxes and input fields look ugly on Chrome 83+?
  Chrome updated the default rending of form elements and it's ugly. You can disable it here: chrome://flags/#form-controls-refresh
Why isn't Twitter integration working?
  Twitter integration requires that you allow twitter.com domain to set cookies. Please ensure that you are not blocking that.
Why isn't LinkedIn integration working?
  LinkedIn integration requires that you allow www.linkedin.com domain to set cookies. Please ensure that you are not blocking that.

### Known Issues

Please check this list for known issues. If you can't find an answer there, please contact us at feedbro.reader@gmail.com

### Support Feedbro Development

We love our users. We want to provide the best possible product for you. More users means that we have more interest to develop Feedbro further. If you like Feedbro, please consider donating (red heart icon in the top left-hand corner) or help us gain more users.
If you want to help, there are many ways to do this:

- Write a positive review about Feedbro on Chrome Web Store
- Write a positive review about Feedbro on Mozilla Add-on Store
- Like Feedbro on alternative.to
- Like Feedbro on slant.co
- Like Feedbro on facebook.com
- Follow Feedbro on twitter.com
- Post an article about Feedbro e.g. on Twitter, Facebook, Reddit, forum, your site or blog.
- Tell your friends and co-workers about Feedbro.
- Send us feature + enhancement ideas and bug reports (if you find bugs) at feedbro.reader@gmail.com

Thanks a lot for your support in advance!

### Feedback and Bug Reports

Please send feedback and bug reports to feedbro.reader@gmail.com

### Change Log

Feedbro change history is listed in Change Log.