| App | Description | Deploy |

|---|---|---|

| [**Sipp**](apps/sipp) | Minimal code sharing with web UI and TUI | [![Deploy on Railway](https://railway.com/button.svg)](https://railway.com/deploy/Axcf_D?referralCode=JGcIp6) |

| [**Feeds**](apps/feeds) | Minimal RSS reader with FreshRSS and OPML support | [![Deploy on Railway](https://railway.com/button.svg)](https://railway.com/deploy/Ezvmhx?referralCode=JGcIp6) |

| [**Parcels**](apps/parcels) | Minimal package tracking (USPS) | [![Deploy on Railway](https://railway.com/button.svg)](https://railway.com/deploy/HNQUs4?referralCode=JGcIp6) |

| [**Jotts**](apps/jotts) | Minimal markdown notes app | [![Deploy on Railway](https://railway.com/button.svg)](https://railway.com/deploy/DLhUhH?referralCode=JGcIp6) |

| [**OG**](apps/og) | Open Graph tag inspector | [![Deploy on Railway](https://railway.com/button.svg)](https://railway.com/deploy/OdXBt_?referralCode=JGcIp6) |

| [**Shrink**](apps/shrink) | Image compression and resizing | [![Deploy on Railway](https://railway.com/button.svg)](https://railway.com/deploy/enYUFb?referralCode=JGcIp6) |

## Quickstart

1. Make sure [Rust](https://www.rust-lang.org/tools/install) is installed

```bash

rustc --version

```

2. Clone and build

```bash

git clone https://github.com/stevedylandev/feeds

cd feeds

cargo build

```

3. Run the dev server

```bash

cargo run

# Server running on http://localhost:3000

```

### Environment Variables

| Variable | Description | Default |

|---|---|---|

| `FRESHRSS_URL` | URL of your FreshRSS instance | — |

| `FRESHRSS_USERNAME` | FreshRSS username | — |

| `FRESHRSS_PASSWORD` | FreshRSS password | — |

| `ADMIN_PASSWORD` | Password for the admin panel | — |

| `COOKIE_SECURE` | Enable HTTPS-only cookies | `false` |

## Overview

Feeds is a minimal RSS reader that mimics the original experience of RSS. It's just a list of posts. No categories, no marking a post read or unread, and there is no in-app reading. With this approach you have to read the post on the author's personal website and experience it in its original context. A few highlights:

- Single Rust binary with embedded assets

- Multiple feed sources: URL params, OPML file, or FreshRSS API

- Password-protected admin panel for managing subscriptions

- Feeds API with JSON and OPML export

- Dark themed UI with Commit Mono font

## Structure

feeds/

├── src/

│   ├── main.rs        # Axum server with routing, templates, and static asset serving

│   ├── feeds.rs       # Feed fetching, OPML parsing, and FreshRSS API integration

│   ├── auth.rs        # Session-based authentication with constant-time password verification

│   └── models.rs      # Data structures for feeds and FreshRSS responses

├── templates/         # Askama HTML templates

├── assets/            # Static assets embedded at compile time via rust-embed

├── Dockerfile

└── docker-compose.yml

### Docker (recommended)

cp .env.sample .env

# Edit .env with your credentials

docker compose up -d

### Binary

cargo build --release

The resulting binary at `./target/release/feeds` is self-contained with all assets embedded. Copy it to your server with a configured `.env` file and run it directly.

## License

[MIT](LICENSE)

## Quickstart

git clone https://github.com/stevedylandev/og.git

cd og

cargo build --release

./target/release/og

### Environment Variables

| Variable | Description | Default |

|---|---|---|

| `PORT` | Server port | `3000` |

## Overview

A self-hosted Open Graph tag inspector built with Rust. Enter any URL and instantly see its OG metadata. A few highlights:

- Single Rust binary with embedded assets

- Inspects title, description, image, and other OG tags

- Dark themed UI with Commit Mono font

- No database needed — fully stateless

## Structure

```

og/

├── src/

│   ├── main.rs        # Entry point and server startup

│   ├── server.rs      # Axum routes and request handling

│   └── og.rs          # Open Graph tag fetching and parsing

├── templates/         # Askama HTML templates

│   ├── base.html      # Base layout

│   ├── index.html     # Search form

│   └── results.html   # OG tag results display

├── static/            # Fonts, favicons, and styles

├── Dockerfile

└── docker-compose.yml

```

### Docker (recommended)

git clone https://github.com/stevedylandev/og.git

cd og

docker compose up -d

```

### Binary

```bash

cargo build --release

The resulting binary at `./target/release/og` is self-contained with all assets embedded. Copy it to your server and run it directly.

Start a server and create a snippet:

# Or use the interactive TUI

## Overview

A single binary for code sharing with a web server and interactive TUI. A few highlights:

- Create snippets and share on the web

- Raw output for CLI tools — `curl`, `wget`, and `httpie` get plain text automatically

- Interactive TUI with authenticated access for snippet management

- Minimal, fast, and low memory consumption

> [!WARNING]

> A small demo instance runs at [sipp.so](https://sipp.so). All snippets created there are public and might be deleted at any time; host your own instance with your own API key for personal use!

## Usage

### Install

Sipp can be installed several ways:

#### Releases

#### Homebrew

#### Cargo

If you are running `sipp` in the same directory as the `sipp.sqlite` file created by the server instance, the TUI will automatically access the database locally and you can edit it directly.

## Structure

```

sipp/

├── src/

│   ├── main.rs        # CLI argument parsing and entry point

│   ├── lib.rs         # Library exports

│   ├── server.rs      # Axum web server, routes, and templates

│   ├── tui.rs         # Interactive terminal UI

│   ├── db.rs          # SQLite database layer

│   ├── backend.rs     # Local/remote backend abstraction

│   ├── config.rs      # Config file management

│   └── highlight.rs   # Syntax highlighting with custom themes

├── templates/         # Askama HTML templates

│   ├── index.html     # Snippet list

│   ├── snippet.html   # Single snippet view

│   └── admin.html     # Admin page

├── static/            # Fonts, favicons, and styles

├── Dockerfile

└── docker-compose.yml

```

Since Sipp is a single binary it can be run in virtually any environment.

### Docker (recommended)

### Binary

```bash

cargo build --release

```

The resulting binary at `./target/release/sipp` is self-contained with all assets embedded. Copy it to your server with your environment variables configured and run it directly.

## License

[MIT](LICENSE)