Skip to content

Unofficial cross platform tool for migrating between browsers, backing up, and restoring from backups, "Reddit Enhancement Suite" aka RES settings.

License

Notifications You must be signed in to change notification settings

gmcclure382/RESTool

 
 

Repository files navigation

RESTool

For stable release please see download link below, the current master branch is for development only and may be broken and lead to loss of data!

Unofficial cross platform tool for migrating between browsers, backing up, and restoring from backups, "Reddit Enhancement Suite" aka RES settings.

This application is in no way affiliated with RES and all issues should be reported to author and not RES authors or subreddits that are used for RES troubleshooting/issue reporting.

See Features for a list of software features, Screenshots to see how it looks like or simply jump to Downloads to see how you can get it.

For explanation of the options available see Usage section and for any issues Help section and for other common questions see FAQs.

If you have any questions you can contact me directly via email that's visible on my GitHub Profile

Seeing how this is version 0.1 manual backup, just in case something goes wrong, of RES settings file is recommended. See This page for information on how to make manual backup

  • License: Apache license Version 2.0. See LICENSE file for more info.

Features

  • Backup RES settings from Chrome and Firefox
  • Restore RES settings
  • Migrate data between browsers
  • Restore settings into a different browser
  • Cross platform (Linux and Windows only at the moment)
  • Simple to use GUI (see screenshot below)

Screenshots

Linux xubuntu 14.04:

docs/0.1.0dev_linux.png

Windows 7:

docs/0.1.0windows.PNG

Downloads

Windows

Note: The only requirement is Microsoft Visual C++ 2008 Redistributable which you probably already have installed, but if you can not get the app to run try installing visual c++ 2008 redistributable from the link above.

You can find the latest stable build here: https://github.com/Nikola-K/RESTool/releases

Windows Vista and up are supported. Tested on Windows 7 32bit.

Linux

There is no binary provided for linux but the only requirements are Python 2.7 and pyqt, both of which are available in most distro repos. You can run the application, after installing pyqt, by simply downloading the source from releases and running RESTool_main.py from your command line.

Tested on xubuntu 32bit.

Usage

This section gives short description of every feature available:

Firefox profile

Firefox supports multiple profiles; you can pick (if you have more than one) which profile to use for the other features.

Chrome to Firefox

Replaces your Firefox RES settings with settings from Chrome RES. RES has to be installed in both browsers for this feature to work.

Note: Migrating settings may fail, or make no changes to RES settings, if one or both browsers are running.

Firefox to Chrome

Replaces your Chrome RES settings with settings from Firefox RES. RES has to be installed in both browsers for this feature to work.

Note: Migrating settings may fail, or make no changes to RES settings, if one or both browsers are running.

Backup Chrome

Copy the RES settings file from its location in Chrome data folder to subfolder named res_backups in the same directory as the application. If the folder does not exist it will be created. Make sure that your account has the necessary permissions to write changes to the location of the application.

Backup Firefox

Copy the RES settings file from its location in Firefox data folder to subfolder named res_backups in the same directory as the application. If the folder does not exist it will be created. Make sure that your account has the necessary permissions to write changes to the location of the application.

Restore selected backup to Chrome

Restores the currently selected backup file in the list on the right to Chrome RES settings.

The backup file can be either backup created either using "Backup Chrome" or "Backup Firefox" feature.

Restore selected backup to Firefox

Restores the currently selected backup file in the list on the right to Chrome RES settings.

The backup file can be either backup created either using "Backup Chrome" or "Backup Firefox" feature.

Pay for RESTool

Opens a PayPal link to pay the amount picked in the dropbox on the right. See FAQs for more info about paid vs free option.

Donate to RES

Opens website with info on how you can donate to RES and its author.

Delete selected backup file

Remove the selected backup file in the list permanently from the disk. This can not be undone.

Help

Can not start the application

Make sure you have Microsoft Visual C++ 2008 Redistributable installed

How to report the issues

Create a file named log.txt in the same location as the application and the necessary debug information should be saved in it. Try running the application and reproducing the issue. You can report the issue by opening a new issue on github, sending an email or contacting the author some other way.

You can upload the log file to pastebin.com, for example, if it's long.

If you're running OS X or Windows XP (or older) or browsers other than Firefox and Chrome those operating systems and browsers are not supported so I can not guarantee that the issue you're having will be fixed.

Important: As of version 0.2.0 the log file may contain some personal data, or even passwords (if they are saved using RES) you should remove any personal data you're not comfortable with sharing from the log file before submitting it.

FAQs

Q: Why is the windows .exe size so big?

A: This application is written using Python and PyQt and "compiled" into an exe file using py2exe. Due to the nature of Python programming language, which does not offer native option to generate a single .exe, the whole python and all the application dependencies are packed into one .exe file and extracted upon runtime.

Q: Why isn't OSX and/or [your favorite browser] supported?

A: I simply do not use them and no OS data is available for RES usage so I just picked two OS that I use and two most popular browsers (Firefox and Chrome). If there is enough interest and support for the application regarding adding more browsers and/or OS it will be added. (Browsers that are not officially supported by RES will not be added)

Q: Option ____ failed. What now?

See the Help section on how to make the application log all the relevant data to a log file which you can then send to author to troubleshoot and fix the issue

About

Unofficial cross platform tool for migrating between browsers, backing up, and restoring from backups, "Reddit Enhancement Suite" aka RES settings.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 98.2%
  • Makefile 1.8%