search

Xyrio / RSSOwlnix

RSSOwlnix is a fork of RSSOwl a powerful application to organize, search and read your RSS, RDF & Atom news feeds in a comfortable way. Highlights are saved searches, notifications, filters, fast fulltext search and a flexible, clean user interface.
Eclipse Public License 1.0
237 stars 22 forks source link

How to manually update RSSOwlnix #89

Closed ErikBrown2 closed 4 years ago

ErikBrown2 commented 4 years ago

Hi,

Thanks for maintaining RSSOwl(nix). I use the software already for years and years daily and enjoy it very much. This is the first time that I want to upgrade RSSOwlnix to a newer version but there appears not to be a installation/upgrade executable. Only a compressed set of files. This is fine but what are the instructions for using these files? Should I just overwrite the old files or should I uninstall the old installation first?

Also the description of the data folder is not very clear for computer illiterates. Where do I find the folders @user.home/.rssowl2, @user.home/.rssowl2-beta and @.home/.rssowlnix-betauser ?

After some Googling I found that this must be C:\Users\.rssowl... Maybe it would be handy to mention that in the upgrade announcement.

Thanks again for all the work to maintain this great application.

Xyrio commented 4 years ago

on windows @user.home is the same as %userprofile% which can be typed in explorer addressbar. the .rssowl* folders are from the different versions that you might be updating from:

if you are updating from older rssowlnix to latest one you can just replace the RSSOwlnix folder of the old installation and leave the .rssowlnix-beta folder as is. rename old one if you want to maybe go back or have changed .ini files manually. then unzip new one to fit previous folder structure so your shortcuts continue to work. afterward you may redo whatever manual .ini file changes you maybe did.

for older versions you can run RSSOwlnix first so it creates the .rssowlnix-beta folder. then while RSSOwlnix is off you just replace the home folder contents with a copy from the old one, which will keep old settings and database. or if you need to reset settings but keep the database, at least the contents of .rssowlnix-beta\.metadata\.plugins\org.rssowl.core which is the database.

if you had addons installed for RSSOwlnix it will prompt you on first start. if you changed the default .rssowlnix-beta location you will have to change the config.ini inside the .rssowlnix-beta folder afterwards again before the rssowlnix restart due to a bug https://github.com/Xyrio/RSSOwlnix/issues/5 .

karnrage commented 3 years ago

Does the .ini file have the list of all the old RSS feeds? If so can I drag and drop into the new install?

Xyrio commented 3 years ago

as i wrote above: at least the contents of .rssowlnix-beta\.metadata\.plugins\org.rssowl.core which is the database thats where the rss feeds and content so far are saved.

the target folder should be empty. start rssowlnix once so it creates the folder (if you have problems on windows because of the dot at the start of a folder name) then do the copying.

so from .rssowl2\.metadata\.plugins\org.rssowl.core or .rssowl2-beta\.metadata\.plugins\org.rssowl.core to .rssowlnix-beta\.metadata\.plugins\org.rssowl.core

the rssowl.db file is what stores current stuff. other files that are not like it are indixes and other database related things that are better copied too.

after you copy you can do a cleanup to fix any old bugs.