Solving Issues running RSSOwl:
Install and Update questions:
In order to run RSSOwl, make sure that Java is installed. We recommend using version 6, but version 5 is sufficient too.
To make sure you run the latest version of RSSOwl you might check for an update (just click Help | Check for updates). By default RSSOwl automatically performs
an update check after startup.
This setting may be changed (just unselect Tools | Preferences | View | Check for Program Updates after startup).
Updating an existing RSSOwl is very easy! All settings and subscriptions are stored in your user-home directory in a folder called ".rssowl2" that is independent from RSSOwl's installation folder. We recommend using Help | Check for updates to update your version to the latest one. Otherwise, simply copy the new RSSOwl into the same folder of the old RSSOwl, overwriting it.
This can happen in rare situations but is easy to solve. Follow these instructions:
There is no way of migrating all your data from the ancient RSSOwl 1 to RSSOwl 2, sorry. You can however
easily rescue your list of subscriptions and folders to RSSOwl 2. This is not too bad because RSSOwl 1 was
never able to store more than the news that where part of the feed (approx. 20-50). So, when you load the
feeds in RSSOwl 2, you will likely see the same content.
Please follow ollow these instructions:
Instructions for Eclipse 3.4.x:
Yes! Just append /S to the installation executable for a silent install.
RSSOwl automatically creates a folder called .rssowl2 to store the application profile:
Yes! You can point RSSOwl to a OPML file that it should import on the first startup. Just start RSSOwl like this: rssowl -vmargs -Dimport=<OPML File>. Refer to this FAQ entry how to start RSSOwl with a parameter like that. You can create such an OPML file by selecting File | Export from RSSOwl itself. It is even possible to include settings, labels and news filters.
You can export the log file from Help | Export Logfile. In case of a serious error, where RSSOwl would not even start, you can find the log file in the filesystem here:
Many issues can be solved easily by running the clean up operation (Tools | Clean-Up). It will list some recommended operations and ask you for a restart to optimize your profile. If you continue to see issues after running the clean-up operation, read on in this FAQ.
This entry will help you in case RSSOwl refuses to start up or you see errors showing up while using RSSOwl. You can help the developers
making RSSOwl more reliable by letting them know about the issues you see. Make sure to
attach the error log that you can find here.
All the data of RSSOwl lives in a single database. Under certain circumstances, this database can get into a state where RSSOwl is no longer able to properly function. These circumstances usually are a computer crash or a power-cut. We built RSSOwl to be reliable even in these extrem situations, but we can not guarantee reliability in all situations.
Luckily, RSSOwl is creating backups of its database at frequent times. As such, you are able to recover your data from one of these backups.
Please follow these instructions:
At first, please shutdown any running instance of RSSOwl and then open the RSSOwl profile directory:
cd ~/.rssowl2From here, open the folder .metadata\.plugins\org.rssowl.core. The RSSOwl database is called rssowl.db and should be one of the files in that directory. Now, make sure to backup the rssowl.db before making any changes. For instance, copy the file to your Desktop.
-vmargs -Drssowl.reindex=true -Xmx1024mPlease refer to this FAQ entry how to start RSSOwl with parameters like that.
There are two solutions to the out of memory problem. First, you can simply allow RSSOwl to use more memory and so it will be less likely that
you see the problem again. And second, you can change RSSOwl's settings to perform better and use less memory.
Please follow these steps to assign more memory to RSSOwl:
Note: Beginning with RSSOwl 2.1, a new logic was implemented to find a browser to use within RSSOwl. The steps are as follows:
If RSSOwl is running slow for you or RSSOwl suddenly stopped working because your computer was running low on memory, here are some Tips and Tricks that will likely help you.
All your subscriptions and news entries are stored into a database in the profile folder. The more subscriptions and news you have, the larger the database will get. In addition, RSSOwl performs frequent backups of your database. Here are some simple ways to reduce the profile folder size:
If RSSOwl is showing no content for any news you select or the embedded browser is showing an error, then maybe your firewall is blocking RSSOwl from using the embedded browser to display the content. Try turning off your firewall for a moment (while not being connected to the internet) to see if its working then. If the firewall is the reason, configure it to allow connections to 127.0.0.1 on port 8795. This is what RSSOwl uses to retrieve content from. Adding this exception is not causing any harm.
Please make sure that you are running RSSOwl 2.0.5 or later.
Just run RSSOwl like you would do on Windows 32 Bits, there is no need for an extra download. The Java Virtual machine that is necessary to run RSSOwl and any other Java application can run both 32 and 64 Bit applications.
If your operating system language is different from the language you want RSSOwl to use in, you have to tell RSSOwl to use a specific language. In order to do so, start RSSOwl with an additional parameter -nl followed by the two letter language code, for example: -nl de for german. Refer to this FAQ entry how to start RSSOwl with a parameter like that.
The translations of RSSOwl are provided by the community and there is lots of work involved. However, some words might be missing from the translation or translated wrong. In this case, you can help us out correcting the translation. Please read on in our wiki if you can help us.
Please refer to this news post on how to get rid of this annoying dialog: http://www.rssowl.org/node/311
We use our Forum to track suggestions and bug reports. Please report anything to http://dev.rssowl.org.
Yes! Just select Help | Tutorial or press F1. You can also take a look at the Overview page on this web site that describes many of the features in RSSOwl.
Yes! RSSOwl is translated into different languages. You can either download a translated version from our downloads page or install additional languages into your RSSOwl (Tools | Language | Download Additional Languages). If your language is not supported yet, you can help us.
At some point you might want to start RSSOwl with a specific parameter to control some specific behavior or restore to a previous backup. Please follow this advise depending
on the operating system you are running RSSOwl on:
Refer to this FAQ entry how to start RSSOwl with a parameter like the following.
Just pass -noSplash to the rssowl launcher. Example: rssowl.exe -noSplash on windows. Refer to this FAQ entry how to start RSSOwl with a parameter like that.
Note that using Mozilla as Browser in RSSOwl lacks quite some features over using
Internet Explorer. If your only concern against using IE is it's vulnerability against
Note that you can only use the rendering engine of Mozilla inside RSSOwl. Any other feature of Mozilla or Firefox can not be used from within RSSOwl. Download XULRunner for your operating system:
This is a known issue called hotlink protection and there is a workaround at least on Windows when using XULRunner:
This is a known issue. To solve it, you have to remove the keybinding for Copy in Tools | Preferences | Overview | Keys.
The notification window showing incoming news supports the following key bindings provided it has the keyboard focus:
Execute xulrunner.exe --unregister-global from the command line. If that does not work, you can force to use Internet Explorer by starting RSSOwl with the parameter -vmargs -DnoXulrunner.
Here are the steps to turn off the click sounds when using RSSOwl:
Beginning with RSSOwl 2.0.4, the behavior of feeds that open on startup has changed slightly in case you have disabled tabs in preferences. There is a conflicting option that is enabled by default that will reopen the last opened feed on startup. If tabs are not enabled, then only one tab can be displayed at the same time. To ensure your selected feed opens on startup, do as follows:
If the browser supports a startup parameter to open links in the background, you can simply append it after the path for the browser executable in preferences. For Firefox, you can do this:
Yes! Simply run File | Export and select all your feeds, labels, filters and preferences. On the other
PC, start RSSOwl and select File | Import to import everything back.
In order to also keep your articles synchronized between different PCs, you should configure Google Reader Synchronization.
Yes! Simply run File | Import and select to import from Google Reader.
RSSOwl is supporting RSS versions 0.91, 0.92 and 2.0, RDF version 1.0, Atom Syndication Format 0.3, 1.0 and OPML.
Uninstalling add-ons in RSSOwl is a 2-step process. At first, the add-on has to be disabled before it can be uninstalled. A disabled add-on can always be enabled again later if you think that you want the add-on back. To disable an add-on:
With a separate add-on you can read any newsgroup inside RSSOwl as if the newsgroup was a normal feed. To install the add-on select Tools | Add-ons | Find Add-ons and choose the Simple Newsgroup Support from the list. To add a new newsgroup, simply create a new bookmark and use the following format for the Link: news://server/groupname (e.g. news://news.eclipse.org/eclipse.platform.swt).
Use the Import Wizard (Tools | Find more Feeds) to either search for feeds by keyword or from a web site of your interest.
If RSSOwl attemps to open a newsfeed from a site that is protected with a username and password it opens a dialog for you to authenticate. After a successfull authentification the newsfeed is displayed. You can manage stored passwords from Tools | Preferences | Passwords and even assign a master password to protect them.
Yes. However, you need to let RSSOwl know. The following is an example for how to achieve this with the RSS feed of a GMail account. We want to subscribe to the GMail account with 2 different accounts:
Yes! Configure the proxy in Tools | Preferences | Overview | Network Connections.
RSSOwl checks for updates on each startup. This eventually brings up a dialog asking for proxy credentials. You can disable the automatic update check setting a startup parameter -vmargs -DdisableUpdate=true. Refer to this FAQ entry how to start RSSOwl with a parameter.
Yes! Just select the article and select PrintFriendly from the list of share providers (News | Share News).
Yes! You can configure this globally (Tools | Preferences | Feeds | Display) or per feed (Edit | Properties | Display).
The Browser looks for plug-ins in ~/.mozilla/plugins and <nativeBrowserDir>/plugins. If a plug-in is installed anywhere else then MOZ_PLUGIN_PATH must be set in order to find it, see http://www.eclipse.org/swt/faq.php#mozillaplugins.
Note: Beginning with RSSOwl 2.1 this feature can be turned off (Tools | Preferences | Feeds | Reading | Mark Duplicate News as Read).
Whenever a feed gets reloaded, RSSOwl has to compare the news that are part of the feed with the news that where downloaded from a previous reload to find out:
RSSOwl 2.0 uses a couple of technologies that make it possible to add new features
very easily and allows one to manage, search and read news in a way that is far beyond
what RSSOwl 1.x supports.
Please refer to this FAQ entry how to improve RSSOwl for best performance.
If you are subscribed to more than 200 feeds, you will notice that RSSOwl 2.0 performs a lot better compared to RSSOwl 1.x
Because RSSOwl 2.0 is at least three times cooler than any previous version ;-).
Consider starting the RSSOwl Tutorial from Help | Tutorial that will help you getting started with RSSOwl. You can also use our public forums to ask questions. Otherwise, either contact Benjamin, or visit us in our IRC Channel #rssowl at irc.freenode.net.