Vienna is a freeware, open source RSS/Atom newsreader for the Mac OS X operating system.
Objective-C HTML CSS Shell Swift Ruby Makefile
Latest commit b6013cd Apr 22, 2017 @barijaona barijaona committed on GitHub Merge pull request #853 from Eitot/appdelegate
Remove some unused code from AppController :
- Moves the Dock menu to Interface Builder
- Restores the default background of the sidebar
- Removes unused outlets
Permalink
Failed to load latest commit information.
3rdparty Update autorevision to 1.20. Mar 13, 2017
Interfaces Merge pull request #853 from Eitot/appdelegate Apr 22, 2017
Pods Uninstall CDEvents pod and update credits Mar 27, 2017
Resources Delete unused images Apr 2, 2017
SharedSupport Fix Delicious URL Jan 11, 2017
SyntaxHighlighter No commit message Aug 28, 2011
Vienna Tests Provide unit testing for DirectoryMonitor Mar 27, 2017
Vienna.xcodeproj Merge pull request #853 from Eitot/appdelegate Apr 22, 2017
Vienna.xcworkspace Pod install Feb 2, 2015
Vienna Replace scripts menu-bar icon Mar 27, 2017
configs Merge pull request #817 from Eitot/credits Mar 13, 2017
signing More lenient code signing requirement Aug 8, 2014
src Merge pull request #853 from Eitot/appdelegate Apr 22, 2017
.gitignore Updated help book script for the new help book format Mar 3, 2017
.travis.yml Updated Travis CI config to xcode 8.3 image Apr 9, 2017
CHANGES Upgrade version number to 3.1.8 Nov 25, 2016
CONTRIBUTING.md Updated unit tests and added contrib notes Sep 11, 2016
Credits.rtf Uninstall CDEvents pod and update credits Mar 27, 2017
LICENCE.md Create LICENCE.md Jan 26, 2015
Makefile moved article status from #define to an enum Mar 8, 2015
Podfile Uninstall CDEvents pod and update credits Mar 27, 2017
Podfile.lock Uninstall CDEvents pod and update credits Mar 27, 2017
README.md Update README.md for Crowdin Apr 4, 2017
Release Instructions.md Replace vienna-rss.org URLs with vienna-rss.com Mar 9, 2017
notes.html Upgrade version number to 3.1.8 Nov 25, 2016

README.md

Vienna

Build Status Crowdin Gitter chat

Vienna is an RSS/Atom 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 the Open Reader API (an adaptation of the now deceased Google Reader API). Vienna has been successfully tested with BazQux.com, FeedHQ.org, InoReader.com and TheOldReader.com.

Compatibility

Vienna 3.1.x requires a minimum of Mac OS X 10.8 (Mountain Lion). The next version of Vienna (3.2.x) will require a minimum of Mac OS X 10.9 (Mavericks).

Installing

Admins upload release and test versions at bintray and Sourceforge.
Alternatively, you can download releases from the GitHub Releases page

Homebrew

Vienna is also available as a Cask for Homebrew Cask.

brew cask install vienna

Getting support

If the in-application help files and the FAQs don’t answer your questions, head over to our Support forum which is hosted by Cocoaforge.

Reporting an issue

If after reading the forum and 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 an issue on 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 thread or message on the Cocoaforge forum.

Contributing

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

Localizing

We need help keeping Vienna translations up to date into different languages. Apart from English, here are the languages for which a localization effort has started:

  • Basque (eu)
  • Simplified Chinese (zh-Hans)
  • Traditional Chinese (zh-Hant)
  • Czech (cs)
  • Danish (da)
  • Dutch (nl)
  • French (fr)
  • Galician (gl)
  • German (de)
  • Italian (it)
  • Japanese (ja)
  • Korean (ko)
  • Portuguese (pt)
  • Brazilian Portuguese (pt-BR)
  • Russian (ru)
  • Spanish (es)
  • Swedish (sv)
  • Turkish (tr)
  • Ukrainian (uk)

You can contribute localizations at Crowdin. Registration is required, but the account is free. Although Crowdin is preferred, you can also submit localizations via pull request, by editing the relevant files (e.g. *.strings) 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 to this document. Have a look at existing styles in the Styles folder.

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 to this document. Have a look at existing plugins in the Plugins folder.

Writing code

The current version of Vienna requires Xcode 8.x and macOS 10.12 SDK. Most of Vienna is made with Objective-C but some newer code is being created in Swift 3.x and we welcome both Objective-C and Swift contributions.

Vienna uses cocoapods for managing dependencies. When building, make sure to always open the Xcode workspace Viennna.xcworkspace instead of a project file.

You should have a basic knowledge of Git and read this suggested workflow.

As a starting point, search for any issues with the help-wanted label.

Please let us know what you are working on by posting an issue on Vienna's github and assigning it to yourself.

For more information please check CONTRIBUTING.md.

Licensing

Apache License, Version 2.0.