Subs - Simplistic Open Source Subscription Cost Tracker

Subs is a lightweight application designed to help you track and manage your subscription costs across different services. With a clean and intuitive interface, it simplifies the process of monitoring your recurring expenses.

Features

• Track Subscriptions: Add, edit, and delete subscription details including name, price, and currency
• Automatic Favicon Fetching: Visual identification of your subscriptions with icons from their domains
• Multi-Currency Support: Track subscriptions in different currencies with automatic conversion rates
• Total Cost Calculation: See your total monthly expenses at a glance
• Import/Export: Easily back up your subscription data or move it between devices
• Client-Side Storage: Option to store data in your browser for privacy or use SQLite for persistence
• Responsive Design: Works seamlessly on both desktop and mobile devices

Demo

You can try out Subs without installing anything at subs.ajnart.fr

Tech Stack

Subs is built with modern web technologies:

• Framework: Remix (React)
• Styling: Tailwind CSS with Shadcn UI components
• State Management: Zustand
• Package Manager: Bun

🚀 Installation

🌐 Use the Online Version

Visit subs.ajnart.fr to use the tool immediately without installation.

🐳 Run with Docker

Run with a single command:

docker run -p 7574:7574 -v ./data:/app/data --name subs --rm ghcr.io/ajnart/subs

Then visit http://localhost:7574 in your browser.

📦 Using Docker Compose

Create a docker-compose.yaml file:

services:
  subs:
    image: ghcr.io/ajnart/subs
    container_name: subs
    ports:
      - "7574:7574"
    restart: unless-stopped
    # volumes: Optional: Uncomment to use a volume to save data outside of the default docker volume
      # - ./data:/app/data
    # environment:
      # - USE_LOCAL_STORAGE=true  # Uncomment to use browser storage instead of file storage (different config for each browser)

Then run:

docker-compose up -d

Open http://localhost:7574 in your browser to see the webui

[!NOTE] Data is stored in the /app/data directory inside the container. Mount this directory as a volume to persist your data between container restarts.

Contributing

Contributions are welcome! Feel free to open issues or submit pull requests to help improve Subs.

License

This project is open-source and available under the MIT License.

---

Thank you for your interest in Subs! We hope it helps you keep better track of your subscription costs.