ellite / Wallos

Wallos: Open-Source Personal Subscription Tracker 
## Table of Contents
- Introduction
- Features
- Demo
- Getting Started
 - Prerequisites
 - Baremetal
 - Docker
 - Installation
 - Baremetal
 - Updating
 - Docker
 - Docker-Compose
- Usage
- Screenshots
- OIDC
- API Documentation
- Contributing
 - Contributors
 - Translations
- License
- Links
## Introduction
Wallos is a powerful, open-source, and self-hostable web application designed to empower you in managing your finances with ease. Say goodbye to complicated spreadsheets and expensive financial software – Wallos simplifies the process of tracking expenses and helps you gain better control over your financial life.
## Features
- Subscription Management: Keep track of your recurring subscriptions and payments, ensuring you never miss a due date.
- Category Management: Organize your expenses into customizable categories, enabling you to gain insights into your spending habits.
- Multi-Currency support: Wallos supports multiple currencies, allowing you to manage your finances in the currency of your choice.
- Currency Conversion: Integrates with the Fixer API so you can get exchange rates and see all your subscriptions on your main currency.
- Data Privacy: As a self-hosted application, Wallos ensures that your financial data remains private and secure on your own server.
- Customization: Tailor Wallos to your needs with customizable categories, currencies, themes and other display options.
- Sorting Options: Allowing you to view your subscriptions from different perspectives.
- Logo Search: Wallos can search the web for the logo of your subscriptions if you don't have them available for upload.
- Mobile view: Wallos on the go.
- Statistics: Another perspective into your spendings.
- Notifications: Wallos supports multiple notification methods (email, discord, pushover, telegram, gotify and webhooks). Get notified about your upcoming payments.
- Multi Language support.
- OIDC with OAuth
- AI Recommendations with ChatGPT, Gemini or Local Ollama
## Demo
If you want to try Wallos, a demo is available at https://demo.wallosapp.com. 
The database is reset every 2 hours. 
To access the demo use the following credentials:
 [code] 
## Getting Started
See instructions to run Wallos below.
### Prerequisites
#### Baremetal
- NGINX or APACHE websever running
- PHP 8.3 with the following modules enabled:
 - curl
 - dom
 - gd
 - intl
 - openssl
 - sqlite3
 - zip
 - mbstring
 - fpm
#### Docker
- Docker
### Installation
#### Baremetal
1. Download or clone this repo and move the files into your web root - usually `/var/www/html`
2. Rename `/db/wallos.empty.db` to `/db/wallos.db`
3. Open the app in your browser — migrations run automatically on the registration page
4. Add the following scripts to your cronjobs with `crontab -e`
 [code] 
5. If your web root is not `/var/www/html/` adjust the cronjobs above accordingly.
#### Updating
1. Re-down