Vienna is a freeware, open source RSS/Atom newsreader for the Mac OS X operating system.
Objective-C HTML CSS Shell Ruby Makefile
Latest commit f5a0982 Aug 16, 2016 @josh64x2 josh64x2 committed on GitHub Merge pull request #705 from barijaona/bugfixes
Bugfixes : 'B' and 'N' keys, status text
Permalink
Failed to load latest commit information.
3rdparty Merge pull request #586 from dak180/topic/build-system Mar 24, 2016
Interfaces Fix article selection through right-click menu in Unified layout Jul 3, 2016
Pods Add OCMock pod to Vienna Tests target Jul 14, 2016
Resources Add a new, mixed set of default feeds representing the wide variety of Jul 20, 2016
SharedSupport Force images to scale correctly Jun 7, 2016
SyntaxHighlighter No commit message Aug 28, 2011
Vienna Tests Fix a test which failed on me Jul 21, 2016
Vienna.xcodeproj xcodeproj cleanup Jul 21, 2016
Vienna.xcworkspace Pod install Feb 2, 2015
configs Archives are created with .tar.gz extension (instead of .tgz) May 8, 2016
lproj small fixes and added new translations to Russian language Jul 29, 2016
palettes Fixed a JSON issue on 10.6.x. Google Reader Sync back to work! Jan 17, 2012
signing More lenient code signing requirement Aug 8, 2014
src Fix ‘B’ key to always go to first unread article Aug 14, 2016
utilities/DisclosableView.framework Include a build of DisclosableView in source package, to make install… Mar 16, 2013
.gitignore Removed .lock from gitignore Feb 5, 2016
.travis.yml Updated travis to xcode 7.3 May 12, 2016
Acknowledgements.rtf Upgrade version number to 3.1.6 Release Candidate 2 Jul 23, 2016
CHANGES Upgrade version number to 3.1.6 Release Candidate 2 Jul 23, 2016
DatabaseSchema.doc Update parts of documentation Dec 11, 2012
LICENCE.md Create LICENCE.md Jan 26, 2015
Makefile moved article status from #define to an enum Mar 8, 2015
Podfile Add OCMock pod to Vienna Tests target Jul 14, 2016
Podfile.lock Add OCMock pod to Vienna Tests target Jul 14, 2016
README.md Fixing typo Jul 19, 2016
Release Instructions.md Add a precision in release instructions May 29, 2016
notes.html Upgrade version number to 3.1.6 Release Candidate 2 Jul 23, 2016

README.md

Vienna

Build Status Stories in Ready

Vienna is an RSS/Atom reader for Mac OS X.

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.

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 and translating

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:

  • German
  • French
  • Swedish
  • Italian
  • Dutch
  • Traditional Chinese
  • Spanish
  • Japanese
  • Korean
  • Brazilian Portuguese
  • Simplified Chinese
  • Danish
  • Czech
  • Euskara (Basque)
  • Russian
  • Ukrainian

Have a look at current localizations in their respective .lproj folders. While translating, the LangSwitch freeware might be handy for checking contexts.

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 7.

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 these advices on workflow.

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

Licensing

Apache License, Version 2.0.