Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/josh-berry/tab-stash

Firefox extension to save and restore tabs as bookmarks. Clear your tabs, clear your mind.
https://github.com/josh-berry/tab-stash

bookmark bookmark-manager firefox firefox-addon firefox-extension firefox-webextension sidebar tab-stash tabs tabs-management webextensions

Last synced: 11 days ago
JSON representation

Firefox extension to save and restore tabs as bookmarks. Clear your tabs, clear your mind.

Awesome Lists containing this project

README 

        
# Tab Stash



[![ci](https://github.com/josh-berry/tab-stash/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/josh-berry/tab-stash/actions?query=branch%3Amaster+)

[![codecov](https://codecov.io/gh/josh-berry/tab-stash/branch/master/graph/badge.svg)](https://codecov.io/gh/josh-berry/tab-stash)



Can't keep all your tabs straight? Need to clear your plate, but want to come

back to your tabs later?



Tab Stash is a no-fuss way to save and organize batches of tabs as bookmarks.

Sweep your browser clean with one click of the Tab Stash icon (if configured).

Your open tabs will be stashed away in your bookmarks, conveniently organized

into groups. When it's time to pick up where you left off, open Tab Stash and

restore just the tabs or groups you want.



Screenshot



## Want to give it a try?



Install Tab Stash from [Mozilla Add-Ons][amo]!



[amo]: https://addons.mozilla.org/firefox/addon/tab-stash/



## Build and Packaging Instructions



You'll need a UNIX-like system (e.g. Mac or Linux) to build Tab Stash.

Unfortunately, building on Windows is not supported due to the multiple build

steps involved (although patches to make the build more cross-platform are

welcome). Here's what you need to do:



1. Install dependencies. You can use the handy `install-deps.sh` script to do

   it automatically on supported OSes/distros (latest macOS and Ubuntu 22.04 are

   known to work). Or if you prefer to do it manually, install the following:



   - GNU `make`, `git`, `diff`, `patch`, `rsync`, `zip` (plus the usual set of

     standard UNIX utilities like `mkdir`, `sed`, etc.)



   - Node.js and `npm` (the latest "Current" or "LTS" release)



   - Inkscape version 1.0 or newer--the CLI must be available as `inkscape` in

     your PATH. (Note that Inkscape is known _not_ to work when installed via

     `snap`; if you're on Ubuntu, please install it with `apt-get` instead.)



2. **To build a debug/development version:** Run `make`. (You can use `-j<...>`

   if you want for a parallel build.)



3. **To build a release version (for packaging or review):**



   1. Make sure your source tree has no uncommitted changes (`git status` should

      say, `nothing to commit, working tree clean`).



   2. `git checkout` the tag for the version you want to build. (Mozilla

      reviewers, you can skip this step--the provided source bundle should

      already have the correct tag checked out.)



   3. Run `make rel`. (You can use `-j<...>` if you want for a parallel build.)



4. You'll get the following artifacts:



   - `dist`: The unpacked Firefox extension



   - `dist-chrome`: A highly-experimental port to Chrome (also unpacked)



   - (release builds only) `releases/tab-stash-X.XX-hhhhhhh.zip`: The packed

     Firefox extension (this is what gets uploaded to AMO)



   - (release builds only) `releases/tab-stash-src-X.XX-hhhhhhh.tar.gz`: A clean

     git checkout of the source tree for the release (also for uploading to AMO)



## Want to help out?



If you're interested in contributing to Tab Stash, be sure to read [the

contributing guidelines][contrib] to get oriented and learn how to submit your

changes for inclusion in future releases.



[contrib]: docs/contributing.md



## Want to re-distribute Tab Stash?



You're more than welcome to do so according to the terms of the

[license](LICENSE), and I'm happy to work with you to make sure Tab Stash users

have a great experience on your platform. I do have a couple requests, though:



- Please _only_ ship release packages that are built using `make rel` per the

  instructions above. Debug builds may cause performance problems or include

  other changes that make for a poor user experience.



- If you find it necessary to apply patches to Tab Stash, please work with me

  _ahead of time_ to get your proposed changes merged into a release. I

  unfortunately cannot provide support to users running patched builds. (If

  your patch introduces a bug, it's going to cause a lot of headache for the

  user only for me to have to tell them to install the official version.)