Skip to content

ViennaRSS/vienna-rss

Repository files navigation

Vienna

Build status Localization status

Viennais an RSS/Atom/JSON Feed reader for macOS.

Vienna can connect directly to the websites you want to track. Additionally or alternatively, you can also sync with a server supporting theOpen Reader API(an adaptation of the now deceased Google Reader API). Vienna has been successfully tested with BazQux, FreshRSS.org, FeedHQ.org, InoReader and TheOldReader.

Compatibility

Version 3.9.x requires a minimum of macOS 10.13 (High Sierra).
Vienna 3.8.x requires a minimum of macOS 10.12 (Sierra).
Vienna 3.6.x and 3.7.x require a minimum of OS X 10.11 (El Capitan).
Vienna 3.2.x to 3.5.x require a minimum of OS X 10.9 (Mavericks).
Vienna 3.1.x requires a minimum of OS X 10.8 (Mountain Lion).
Vienna 3.0.x requires a minimum of OS X 10.6 (Snow Leopard).

Installing

Admins upload release and test versions at theGitHub Releases page.
Alternatively, you can download releases fromSourceforge.

Homebrew

Vienna is also available as a Cask forHomebrew Cask.

brew install --cask vienna

Getting support

If the in-application help files and theFAQdon’t answer your questions, head over to ourDiscussions pageon GitHub.

Reporting an issue

If after reading the Discussions page or asking your questions there, you are convinced that there is a problem in Vienna's code or an important feature is missing, you may open anissueon Github.

Be concise, but as precise as possible to allow other people reproducing the issue. To keep things short, you can provide a link to a relevant discussion.

Contributing

Want to contribute? Great! There are many ways you can, even if you aren't a developer.

Writing code

Please checkCONTRIBUTING.md.

Localizing

We need help keeping Vienna translations up to date into different languages. You can contribute localizations atCrowdin.Registration is required, but the account is free. Contact us if you want to contribute for a language that is not yet listed. Do not localize the project's files directly.

Writing custom styles

Vienna supports a variety of different display styles for articles. These styles are provided on the Styles sub-menu off the View menu. A style is a combination of an HTML template that is used to control the placement of various parts of the article and a CSS stylesheet that controls the appearance of the article.

You can write styles by referring tothis document.Have a look at existing styles in theStylesfolder.

Writing plugins

Vienna supports plugins which are installed in menus and/or on the toolbar and can run defined actions. These plugins are XML-based and can be created by editing a simple.plist-file without any knowledge of Cocoa programming, in as little as 15 minutes.

You can write plugins by referring tothis document.Have a look at existing plugins in thePluginsfolder.

Licensing

Apache License, Version 2.0.