Metadata-Version: 2.3
Name: fireweb-shortcut
Version: 0.1.0
Summary: A lightweight Linux CLI for creating Firefox-powered web shortcuts as native desktop applications.
Author: KahnSvaer
Author-email: KahnSvaer <Shivansh.pachnanda.work@gmail.com>
Requires-Python: >=3.11
Description-Content-Type: text/markdown

# 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:

```bash
git clone <repository-url>
cd fireweb
```

Install using `uv`:

```bash
uv tool install .
```

## Usage

### Create a shortcut

```bash
fireweb create --url chatgpt.com
```

Optionally specify a name:

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

Or use a custom icon:

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

### List shortcuts

```bash
fireweb list
```

Or:

```bash
fireweb -l
```

### Delete a shortcut

By name:

```bash
fireweb delete --name ChatGPT
```

Or by URL:

```bash
fireweb delete --url chatgpt.com
```

## How It Works

Fireweb creates `.desktop` files in:

```text
~/.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](LICENSE).