Metadata-Version: 2.1
Name: the-great-suspender-restore-urls
Version: 0.4
Summary: Restore your thegreatsuspender tabs.
Home-page: http://github.com/barseghyanartur/the-great-suspender-restore-urls
Author: Artur Barseghyan
Author-email: artur.barseghyan@gmail.com
License: GPL-2.0-only OR LGPL-2.1-or-later
Project-URL: Bug Tracker, https://github.com/barseghyanartur/the-great-suspender-restore-urls/issues
Project-URL: Source Code, https://github.com/barseghyanartur/the-great-suspender-restore-urls/
Project-URL: Changelog, https://github.com/barseghyanartur/the-great-suspender-restore-urls/blob/master/CHANGELOG.rst
Keywords: thegreatsuspender,the great suspender
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 5 - Production/Stable
Classifier: Topic :: Internet
Classifier: License :: OSI Approved :: MIT License
License-File: LICENSE

================================
the-great-suspender-restore-urls
================================

Restore the broken URLs of the Great Suspender browser (Google Chrome, Firefox)
extension.

.. image:: https://img.shields.io/pypi/v/the-great-suspender-restore-urls.svg
   :target: https://pypi.python.org/pypi/the-great-suspender-restore-urls
   :alt: PyPI Version

.. image:: https://img.shields.io/pypi/pyversions/the-great-suspender-restore-urls.svg
    :target: https://pypi.python.org/pypi/the-great-suspender-restore-urls/
    :alt: Supported Python versions

.. image:: https://img.shields.io/badge/license-MIT-green.svg
   :target: https://github.com/barseghyanartur/the-great-suspender-restore-urls/#License
   :alt: MIT

Background
==========

If you used to use The Great Suspender Chrome extension, you would notice (as 
of 2021-02-04) that it has been banned by Google Chrome for being a malware.

The last-known-good-version on GitHub, release `v7.1.6 <https://github.com/greatsuspender/thegreatsuspender/releases/tag/v7.1.6>`__,
works well for me, if installed from source. However, your saved
tabs won't reload as something has changed in between the `good` and the `bad`
releases.

What to do? Would you just loose all precious URLs and saved sessions? If you 
are OK with that, just pass by. Otherwise, read further.

How to fix the broken tabs
==========================

Locally (using this package)
----------------------------

1. Use the `FreshStart - Cross Browser Session Manager <https://chrome.google.com/webstore/detail/freshstart-cross-browser/nmidkjogcjnnlfimjcedenagjfacpobb>`__
   extension to export all your tabs into a JSON and save it into a file (for
   instance, name it ``tabs.json``).

2. Install ``the-great-suspender-restore-urls`` (this) package:

.. code-block:: sh

  pip install the-great-suspender-restore-urls

3. Fix your broken tabs:

.. code-block:: sh

    restore-the-great-suspender-urls --in-file=tabs.json --out-file=tabs-restored.json

4. Use the `FreshStart - Cross Browser Session Manager <https://chrome.google.com/webstore/detail/freshstart-cross-browser/nmidkjogcjnnlfimjcedenagjfacpobb>`__
   to import the tabs back (paste the contents of the ``tabs-restored.json``
   in the import session window).

Online
------

Build with FastAPI, VueJS and the ``the-great-suspender-restore-urls`` (this)
package.

- Check the `service <http://great-suspender-restore-urls.herokuapp.com/ui/index.html>`__
- Read the `instructions <http://great-suspender-restore-urls.herokuapp.com/ui/about.html>`__
- Source code is `available <https://github.com/barseghyanartur/the-great-suspender-restore-urls-service>`__.

Usage options
=============

--session-name-suffix
---------------------
By default, your existing session names will get a " - cleaned" suffix.
In order to tweak that, use the ``--session-name-suffix`` argument.

.. code-block:: sh

    restore-the-great-suspender-urls \
        --in-file=tabs.json \
        --out-file=tabs-restored.json \
        --session-name-suffix=' - FIXED' \
        --verbose

--extension-id
--------------
The URL prefix used to identify tabs suspended by ``The Great Suspender``
extension looks as follows:
``chrome-extension://klbibkeccnjlkjkiokjodocebajanakg/suspended.html``,
where the ``klbibkeccnjlkjkiokjodocebajanakg`` is the extension ID.
If you leave this argument out, regular expression match will be used.

.. code-block:: sh

    restore-the-great-suspender-urls \
        --in-file=tabs.json \
        --out-file=tabs-restored.json \
        --extension-id='klbibkeccnjlkjkiokjodocebajanakg' \
        --verbose

--verbose
---------
To have a verbose output, add the ``--verbose`` argument.

.. code-block:: sh

    restore-the-great-suspender-urls \
        --in-file=tabs.json \
        --out-file=tabs-restored.json \
        --verbose

Prerequisites
=============

- Python 3.6, 3.7, 3.8 or 3.9.

License
=======

MIT

Support
=======

For any issues contact me at the e-mail given in the `Author`_ section.

Author
======

Artur Barseghyan <artur.barseghyan@gmail.com>


