Deploy Now

Stars

513

Forks

26

Watchers

5

Developer links

VoucherVault

Stop losing money to forgotten paper gift cards and expired retail coupons by centralizing every voucher, loyalty barcode, and store credit inside VoucherVault, a self-hosted digital wallet accessible from any browser or mobile device. Point your phone camera at physical cards during item creation to scan 1D barcodes and 2D QR codes with automatic format detection, or upload original PDF receipts and image attachments directly to each entry. At the checkout register, pull up high-contrast QR codes and scannable barcodes instantly, even inside underground stores without cellular reception thanks to the manual 48-hour offline caching mode. Gift card balances update automatically as you log individual partial redemptions in the per-item transaction ledger. Configurable Apprise notification rules alert you 30 days and 7 days before any voucher expires across Telegram, Discord, Gotify, Ntfy, or email. Households and teams can share specific cards between accounts while keeping personal items private, and administrators can enable OpenID Connect single sign-on for frictionless login. Multi-currency conversion automatically calculates portfolio totals across international vouchers. A built-in REST API endpoint even exposes live portfolio counts and value statistics directly to Home Assistant dashboards. Running on a dedicated VPS on RepoCloud with guaranteed CPU, RAM, and SSD, full root SSH access, and a browser serial console. GPL-3.0 licensed.

VoucherVault
VoucherVault
VoucherVault
VoucherVault
VoucherVault
VoucherVault

Benefits

  • Never Miss Another Voucher Expiration Date
  • Automated Celery background tasks check expiration dates daily and dispatch customizable Apprise alerts at 30-day and 7-day thresholds across dozens of push notification services.
  • Reliable Checkout Access Without Mobile Signal
  • Progressive Web App installation and manual 48-hour offline browser caching ensure loyalty barcodes and gift card redemption codes load immediately inside brick-and-mortar stores.
  • Complete Gift Card Balance And Ledger
  • Track initial gift card values alongside timestamped spending transactions so you always know the exact remaining balance before heading to the checkout counter.
  • Household Sharing With Enterprise Identity Controls
  • Multi-user accounts allow family members to share specific vouchers or loyalty cards while authenticating securely through OpenID Connect single sign-on providers.

Features

  • Client-Side Barcode Scanner
  • Scans 1D barcodes and 2D QR codes directly from device cameras or uploaded images with automatic symbology detection during item creation.
  • Apprise Expiry Notifications
  • Integrates with Apprise and Django-Celery-Beat to deliver scheduled expiration reminders via email, Ntfy, Gotify, Telegram, Discord, and webhook endpoints.
  • Offline PWA Caching
  • Provides a mobile-ready Progressive Web App interface featuring light and dark themes plus manual 48-hour offline data caching for in-store redemption.
  • OIDC Single Sign-On
  • Supports external OpenID Connect identity providers using HS256 or RS256 JWKS verification, automatic user provisioning, and optional auto-login flows.
  • Home Assistant API
  • Exposes an authenticated REST API endpoint returning total voucher values, item counts, and expiration statistics for Home Assistant dashboard cards.

Apps Similar to VoucherVault