Skip to main content

A lightweight Linux CLI for creating Firefox-powered web shortcuts as native desktop applications.

Project description

Fireweb

Fireweb is a lightweight Linux CLI tool for creating Firefox-powered web shortcuts that appear as desktop applications.

Create shortcuts to your favorite websites, give them custom names and icons, and manage them directly from your terminal.

Features

  • Create Firefox-powered web shortcuts
  • Automatically generate shortcut names from URLs
  • Use custom icons or the default Fireweb icon
  • List all Fireweb shortcuts
  • Delete shortcuts by name or URL
  • No external Python dependencies

Installation

Clone the repository:

git clone <repository-url>
cd fireweb

Install using uv:

uv tool install .

Usage

Create a shortcut

fireweb create --url chatgpt.com

Optionally specify a name:

fireweb create --url chatgpt.com --name ChatGPT

Or use a custom icon:

fireweb create --url chatgpt.com --icon /path/to/icon.png

List shortcuts

fireweb list

Or:

fireweb -l

Delete a shortcut

By name:

fireweb delete --name ChatGPT

Or by URL:

fireweb delete --url chatgpt.com

How It Works

Fireweb creates .desktop files in:

~/.local/share/applications/

Each shortcut launches its URL in a new Firefox window, allowing websites to behave more like standalone desktop applications.

Requirements

  • Linux
  • Firefox
  • Python 3.11+

Status

Fireweb is currently at v0.1.0.

The project is intentionally small and experimental. Bug reports and contributions are welcome.

License

This project is licensed under the MIT License.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fireweb_shortcut-0.1.0.tar.gz (102.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

fireweb_shortcut-0.1.0-py3-none-any.whl (103.7 kB view details)

Uploaded Python 3

File details

Details for the file fireweb_shortcut-0.1.0.tar.gz.

File metadata

  • Download URL: fireweb_shortcut-0.1.0.tar.gz
  • Upload date:
  • Size: 102.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.18 {"installer":{"name":"uv","version":"0.11.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for fireweb_shortcut-0.1.0.tar.gz
Algorithm Hash digest
SHA256 39459080a0fc0a0c48f721cc1a6025ef0fa9ba10dd58995bd7bb7d233b31e8f9
MD5 807141a8e219dc1298182b5354c9b0e8
BLAKE2b-256 0e7f91b8c11dfbea412e0e143ac96b680e6194ba9cd9d47e7170412f5e32d8d3

See more details on using hashes here.

File details

Details for the file fireweb_shortcut-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: fireweb_shortcut-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 103.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.18 {"installer":{"name":"uv","version":"0.11.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for fireweb_shortcut-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f646c2b01e3703249d0834dc5442218ca2c4eca09b678662452cce0a68bbb9aa
MD5 dd283d5eca9edb1e9b414e348c104ec2
BLAKE2b-256 9c40b54d590a015313dd0f68a55d8312617d24bfe37c842bcce2890fea72f8fb

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page