Git/firefox-user.js
1
0
Fork 0
mirror of https://github.com/arkenfox/user.js.git synced 2025-11-01 06:15:26 +01:00
Code Issues Packages Projects Releases Wiki Activity

Updated 1.2 Backing Up (markdown)

Thorin-Oakenpants
2017-03-24 06:11:10 +13:00
parent b9726931e1
commit df44ca09cc
1 changed files with 4 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
1.2-Backing-Up.md

@@ -1,17 +1,11 @@
Hopefully you have read [what](https://github.com/ghacksuserjs/ghacks-user.js/wiki/1.1-Overview) a `user.js` is, what it does, and how it works. It goes in your profile directory and can have a profound effect on all your settings and data. The ghacks user.js is pretty comprehensive, and no one size fits all. It is highly recommended that you backup before using it (or use a new or copied profile for testing).
Hopefully you have read [what](https://github.com/ghacksuserjs/ghacks-user.js/wiki/1.1-Overview) a `user.js` does, and how it works. It can have a profound effect on all your settings and data. The `ghacks user.js` is pretty comprehensive, and no one size fits all - therefore, it is highly recommended that you backup before using it (or use a new or copied profile for testing).
The complete and easiest way to backup is to copy your entire `profile` directory when Firefox is closed. This directory contains many items that a user.js, with certain preferences, can wipe, such as cookies, site specific settings, saved passwords and login names, browsing + download + form history, disk cache, offline website data, active logins and even the favicons on your bookmarks, to name a few.
The complete and easiest way to backup is to copy your entire `profile` directory when Firefox is closed. This directory contains many items that a user.js, with certain preferences, can wipe, such as cookies, site specific settings, saved passwords and login names, browsing + download + form history, disk cache, and more. Just backing up the `prefs.js` file is NOT enough, and not recommended by this wiki.
Your profile directory also includes a `prefs.js` file, which contains many entries that are not related to your specific changes from about:config or imported from the `user.js` (such as internal firefox settings and specific add-on entries). Backing up just this file is not foolproof, but that's not say that if you know what you're doing, you can do otherwise - just do not expect this wiki to cover it.
To find your profile directory, go to `about:profiles`. This will list all profiles, as well as allowing you to create a new one.
To find your profile directory, go to `about:profiles`. This will list all profiles, so make sure to select the one that is marked as the `profile in use`. You will see an `Open Folder` button which you can click.
![about:profiles](https://github.com/ghacksuserjs/ghacks-user.js/blob/master/wikipiki/backup01.png)
Alternatively you can use the menu item `Help>Troubleshooting Information` (which will load an `about:support` page) and search for `Profile Directory`. This method will only show the current profile, with extra information. Either way, you will see an `Open Folder` button.
![about:support](https://github.com/ghacksuserjs/ghacks-user.js/blob/master/wikipiki/backup02.png)
When copying your profile directory, it is advised that Firefox be closed. Rename your copied folder to something meaningful, and keep the original name (for an easy rollback). For example, if the profile folder is called `jiu9k8gm.default`. A backup copy might be called `jiu9k8gm.default-2017-03-22` or `jiu9k8gm.default-pre-ghacks-userjs`.
Be aware, that this is your entire profile. So rolling back will not keep any new cookies, saved passwords, bookmarks, extension changes and the like. The next wiki section, [Implementation](https://github.com/ghacksuserjs/ghacks-user.js/wiki/1.3-Implementation), outlines some methods you could use to test out the `user.js` and preferences, such as using your existing profile, or a copy of it, or a new one and whether to implement piecemeal or whole hog :pig: .
Be aware, that this is your entire profile. So rolling back will not keep any new cookies, saved passwords, bookmarks, extension changes and the like. The next wiki section outlines some methods you could use to [implement](https://github.com/ghacksuserjs/ghacks-user.js/wiki/1.3-Implementation) and test out the `user.js` and various preferences.