Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/vincenzocaputo/firefox-ssb
A tool to bypass the lack of PWAs support in Firefox
https://github.com/vincenzocaputo/firefox-ssb
firefox pwa python ssb
Last synced: 21 days ago
JSON representation
A tool to bypass the lack of PWAs support in Firefox
- Host: GitHub
- URL: https://github.com/vincenzocaputo/firefox-ssb
- Owner: vincenzocaputo
- License: gpl-3.0
- Created: 2020-11-14T18:49:39.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2023-07-30T11:34:00.000Z (over 1 year ago)
- Last Synced: 2023-07-30T13:42:00.997Z (over 1 year ago)
- Topics: firefox, pwa, python, ssb
- Language: Python
- Homepage:
- Size: 30.3 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
This Python tool aims to provide a workaround for the lack of PWAs (Progressive Web Apps) management in Firefox browser. There are already other alternatives to bypass this limitation (such as: https://github.com/filips123/PWAsForFirefox). However, the idea of this project is to avoid relying on add-ons and extensions.
**Caveat:** At the moment, Firefox **does not support** PWAs like Chromium-based browser. This tool is not intended to provide full support for PWAs but wants to offer the ability to create standalone launchers to open websites as Site-Specific Browser.
## How it works
The tool creates a Firefox profile for each web app. Separate profiles are needed to open web apps in separate windows as standalone applications. The tool create a .desktop file for each web app as launcher.
Initially, this tool used the Site-Specific Browser (SSB) feature, but Firefox removed it. Now the tool edits some CSS settings in order to avoid unnecessary functionality usually provided by the web browser ( menus, address bar, toolbars, add-ons etc.).
## Key Features
- No Firefox add-on needed
- Creation of stand-alone launchers for web applications
- Automatic download of web-page favicon (which will be used as launcher icon)
- Deep separation of user data between web applications (your default user profiles aren't affected)
- Simple management of SSB applications (install/edit/uninstall)
# Installing
## Requirements
- Python $>=$ 3.11.4 *required*
## Installation
1. Create a virtual environment (*recommended*)
```
$ python3.8 -m venv .venv
```
2. Activate the virtual envorinment
```
$ source activate virt/bin/activate
```
3. Clone this repository using git:
```
$ git clone https://github.com/VincenzoCaputo/firefox-SSB
```
4. Install dependencies
```
$ pip install -i requirements.txt
```
## User Guide
You can use Firefox-SSB through CLI. You can see help information using this command:
```
$ python firefox-ssb.py --help
```
This tool currently provides four possibile operations:
- install: install a SSB application. You must provide the name of the application, the URL of the associated web page and, optionally, the icon for the web app
- uninstall: remove a web application. Profile folder, icon and launcher will be removed. (**WARNING**: all the user data used by that application will be removed)
- list: get the list of installed applications
- edit: edit the icon of an installed SSB application.
### Install a new web app
```
$ python firefox-ssb.py --name GitHub --url https://github.com/
```
Notice that the tool tries to download automatically the favicon of the web page which will be used as application icon. However, the quality of the image may be low. Therefore I suggest you to specify a custom image.
# Testing
This tool was tested on Fedora Linux 38 (GNOME 44.3) with Firefox 115.0.2