Skip to content

Commit

Permalink
README.md: add casual example
Browse files Browse the repository at this point in the history
  • Loading branch information
Hans-Peter Jansen committed Mar 10, 2020
1 parent 046b80b commit 9d69b75
Showing 1 changed file with 23 additions and 5 deletions.
28 changes: 23 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,10 +60,23 @@ useful in conjunction with Firefox and the

Example Usage
-------------
In order to save your Firefox sessions: install the `Window Titler addon` and
supply all windows with a **unique** title, that should appear in square
brackets in front of the window title, while the normal window title changes
depending on which tab is actived.
Casual approach to restore your Firefox session:
```
wm-win-tool -bc Navigator.Firefox store
```
will save every Firefox window, and
```
wm-win-tool -bc Navigator.Firefox restore
```
will restore all recognized windows. The only downside is, that the window
titles must match **exactly** to be restored correctly. So better make sure to
run this tool right before leaving the session.

A more robust approach to the issue in question: install the
`Window Titler addon` and supply all windows, that you want to have managed
with a **unique** title, that appears in square brackets in front of the
window title. This provides a static title, independent from which tab is
actived.

Now saving a session is as easy as:
```
Expand Down Expand Up @@ -106,6 +119,11 @@ setup.

Final notes
-----------
There are good chances, that the Firefox issue is fixed with Version 75. Hooray.
Let's hope for the best. If all goes well, this tool provides a nice way to
**validate** the final fix. If all windows match, it will not perform any action
on (verbose) restore. :wink:

The commands `store` and `restore` could be implicitly triggered, when executed
via symlinks to `wm-win-tool`, eg.:
```
Expand All @@ -114,7 +132,7 @@ $ ln -s wm-win-tool wm-win-store
$ ln -s wm-win-tool wm-win-restore
```
These operation modes come with some hardcoded defaults: `--bracket` and
`--verbose` for the most usual usage pattern. If that's not enough, a config
`--verbose` for the most usual usage patterns. If that's not enough, a config
file option might be useful (TBD).

The session data is saved in `~/local/share/wm-win-tool`.
Expand Down

0 comments on commit 9d69b75

Please sign in to comment.