SteamVault - Your Personal Steam Library Companion

SteamVault is a desktop app designed to help you manage and visualize your Steam game library locally. It reads your installed games, playtime, and achievements, and allows you to see your statistics — everything stored locally.

SteamVault preview

Note: This is a privacy-focused tool. No data leaves your machine.

Quick Start

For Users (Download & Install)

Download the latest MSI installer from Releases
Run SteamVault_0.1.0_x64_en-US.msi
Follow the installation wizard
Launch SteamVault from your desktop or Start menu
Configure your Steam API Key and Steam ID in Settings

For Developers (Build from Source)

# Clone the repository
git clone https://github.com/TiagoPortilho/SteamVault.git

# Navigate to the project folder
cd SteamVault

# Install dependencies
npm install

# Run the app in development mode
npm run tauri dev

# Build production installer
npm run tauri build

Tip: You can use the Python script run.py to automate development setup.

Technologies Used:

	Node.js – Backend runtime environment
	React – Frontend framework
	Vite – Frontend build tool
	Tauri – Cross-platform desktop app framework (Rust + JS)
	Rust – Backend programming language
Database	SQLite + SQLx – Local database with async queries
Bundle	Tauri Bundle – Application packaging and distribution

Developer:

Tiago Portilho

Key Features:

Steam Game Detection (via API)
Game List with Playtime & Achievements
Add Personal Guides and Notes
Offline Steam Library Tracker
Local Database (SQLite)
Fast & Lightweight (Tauri + Vite)
Privacy-Focused (No Data Collection)
Cross-Platform (Windows, macOS, Linux)

Requirements

For Users:

Windows 10/11 (64-bit)
Steam account with games
Steam Web API Key (free from Steam API)

For Developers:

Node.js 18+
Rust 1.70+
Visual Studio Build Tools (Windows)
Git

Configuration

Get Steam API Key:
- Visit https://steamcommunity.com/dev/apikey
- Create a new key for domain "localhost"
Find Steam ID:
- Open Steam → Settings → Account
- Copy your Steam ID (or use steamid.io)
Configure in App:
- Open SteamVault
- Go to Settings
- Enter your API Key and Steam ID
- Click "Sync Games"

Project Structure

SteamVault/
├── src/                    # Frontend (React)
│   ├── components/         # Reusable components
│   ├── pages/             # App pages
│   ├── assets/            # Images and icons
│   └── styles/            # CSS files
├── src-tauri/             # Backend (Rust)
│   ├── src/
│   │   ├── commands.rs    # Tauri commands
│   │   └── main.rs        # App entry point
│   └── Cargo.toml         # Rust dependencies
├── prisma/                # Database schema (legacy)
└── package.json           # Node dependencies

Development

Available Scripts

npm run tauri dev      # Start development server
npm run tauri build    # Build production app
npm run build          # Build frontend only
npm run preview        # Preview built app

Database

The app uses SQLite for local storage. Database file is created automatically at:

Windows: %APPDATA%\SteamVault\db.sqlite
macOS: ~/Library/Application Support/SteamVault/db.sqlite
Linux: ~/.local/share/SteamVault/db.sqlite

Privacy & Security

No Data Collection: All data stays on your local machine
No Telemetry: No tracking or analytics
API Only: Steam data fetched via official Steam Web API
Local Storage: SQLite database in user data directory
Open Source: Code is fully auditable

Planned Features / Roadmap

Steam Idle Mode – Simulate game running to farm trading cards
Full Local Auto-Scan – Automatically detect all Steam games from files
Framework Base – Transform into template for similar apps
Game Save Backup Manager – Backup and restore game saves
Advanced Statistics – Detailed gaming analytics
Achievement Tracker – Focus on uncompleted achievements

Contributing

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

Development Setup

# Install Rust (if not installed)
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Install dependencies
npm install

# Start development
npm run tauri dev

Support

Issues: GitHub Issues
Discussions: GitHub Discussions
Email: For security issues only

License

This project is licensed under the MIT License.

© 2025 Tiago Portilho – Free for personal and educational use.

SteamVault - Seu Companheiro Pessoal da Biblioteca Steam

SteamVault é um aplicativo desktop projetado para ajudá-lo a gerenciar e visualizar sua biblioteca de jogos Steam localmente. Ele lê seus jogos instalados, tempo de jogo e conquistas, e permite que você veja suas estatísticas — tudo armazenado localmente.

Prévia do SteamVault

Nota: Esta é uma ferramenta focada na privacidade. Nenhum dado sai da sua máquina.

Início Rápido

Para Usuários (Download & Instalação)

Baixe o instalador MSI mais recente das Releases
Execute SteamVault_0.1.0_x64_en-US.msi
Siga o assistente de instalação
Abra o SteamVault da área de trabalho ou menu iniciar
Configure sua chave da API Steam e Steam ID nas configurações

Para Desenvolvedores (Compilar do Código)

# Clonar o repositório
git clone https://github.com/TiagoPortilho/SteamVault.git

# Navegar para a pasta do projeto
cd SteamVault

# Instalar dependências
npm install

# Executar o app em modo de desenvolvimento
npm run tauri dev

# Compilar instalador de produção
npm run tauri build

Dica: Você pode usar o script Python run.py para automatizar a configuração de desenvolvimento.

Tecnologias Utilizadas:

	Node.js – Ambiente de execução backend
	React – Framework frontend
	Vite – Ferramenta de build frontend
	Tauri – Framework de aplicativo desktop multiplataforma (Rust + JS)
	Rust – Linguagem de programação backend
Banco	SQLite + SQLx – Banco de dados local com consultas assíncronas
Pacote	Tauri Bundle – Empacotamento e distribuição de aplicativos

Desenvolvedor:

Tiago Portilho

Principais Recursos:

Detecção de Jogos Steam (via API)
Lista de Jogos com Tempo de Jogo e Conquistas
Adicionar Guias Pessoais e Notas
Rastreador Offline da Biblioteca Steam
Banco de Dados Local (SQLite)
Rápido e Leve (Tauri + Vite)
Focado na Privacidade (Sem Coleta de Dados)
Multiplataforma (Windows, macOS, Linux)

Requisitos

Para Usuários:

Windows 10/11 (64-bit)
Conta Steam com jogos
Chave da API Steam (gratuita em Steam API)

Para Desenvolvedores:

Node.js 18+
Rust 1.70+
Visual Studio Build Tools (Windows)
Git

Configuração

Obter Chave da API Steam:
- Visite https://steamcommunity.com/dev/apikey
- Crie uma nova chave para domínio "localhost"
Encontrar Steam ID:
- Abra Steam → Configurações → Conta
- Copie seu Steam ID (ou use steamid.io)
Configurar no App:
- Abra o SteamVault
- Vá para Configurações
- Digite sua Chave da API e Steam ID
- Clique em "Sincronizar Jogos"

Estrutura do Projeto

SteamVault/
├── src/                    # Frontend (React)
│   ├── components/         # Componentes reutilizáveis
│   ├── pages/             # Páginas do app
│   ├── assets/            # Imagens e ícones
│   └── styles/            # Arquivos CSS
├── src-tauri/             # Backend (Rust)
│   ├── src/
│   │   ├── commands.rs    # Comandos Tauri
│   │   └── main.rs        # Ponto de entrada do app
│   └── Cargo.toml         # Dependências Rust
├── prisma/                # Schema do banco (legado)
└── package.json           # Dependências Node

Desenvolvimento

Scripts Disponíveis

npm run tauri dev      # Iniciar servidor de desenvolvimento
npm run tauri build    # Compilar app de produção
npm run build          # Compilar apenas frontend
npm run preview        # Pré-visualizar app compilado

Banco de Dados

O app usa SQLite para armazenamento local. O arquivo do banco é criado automaticamente em:

Windows: %APPDATA%\SteamVault\db.sqlite
macOS: ~/Library/Application Support/SteamVault/db.sqlite
Linux: ~/.local/share/SteamVault/db.sqlite

Privacidade e Segurança

Sem Coleta de Dados: Todos os dados ficam na sua máquina local
Sem Telemetria: Sem rastreamento ou analytics
Apenas API: Dados do Steam obtidos via API Web oficial do Steam
Armazenamento Local: Banco SQLite no diretório de dados do usuário
Código Aberto: Código totalmente auditável

Recursos Planejados / Roadmap

Modo Idle do Steam – Simular jogo rodando para farmar cartas de troca
Auto-Scan Local Completo – Detectar automaticamente todos os jogos Steam dos arquivos
Base de Framework – Transformar em template para apps similares
Gerenciador de Backup de Saves – Backup e restauração de saves de jogos
Estatísticas Avançadas – Analytics detalhados de jogos
Rastreador de Conquistas – Foco em conquistas não completadas

Contribuição

Faça um fork do repositório
Crie uma branch de feature (git checkout -b feature/recurso-incrivel)
Faça commit das mudanças (git commit -m 'Adiciona recurso incrível')
Push para a branch (git push origin feature/recurso-incrivel)
Abra um Pull Request

Configuração de Desenvolvimento

# Instalar Rust (se não instalado)
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Instalar dependências
npm install

# Iniciar desenvolvimento
npm run tauri dev

Suporte

Issues: GitHub Issues
Discussões: GitHub Discussions
Email: Apenas para questões de segurança

Licença

Este projeto está licenciado sob a Licença MIT.

© 2025 Tiago Portilho – Gratuito para uso pessoal e educacional.

Steam Game Detection (via API)
Game List with Playtime & Achievements
Add Personal Guides and Notes
Offline Steam Library Tracker
Local Database (SQLite + Prisma)
Fast & Lightweight (Tauri + Vite)

Installation & Setup

# Clone the repository
git clone https://github.com/TiagoPortilho/SteamVault.git

# Navigate to the project folder
cd SteamVault

# Install dependencies
npm install

# Push the database schema
npx prisma db push

# Build frontend
npm run build

# Run the app in development mode
npm run tauri dev

Tip: You can use the Python script run.py to automate these steps.

Planned Features / Roadmap

Steam Idle Mode – Simulate the game running to farm Steam trading cards
Full Local Auto-Scan – Automatically fetch all Steam games without user input (file parsing instead of API)
Framework Base – Transform SteamVault into a base template for other apps with similar architecture (Tauri + Vite + Prisma)
Game Save Backup Manager – Backup and restore game save files easily

License

This project is licensed under the MIT License.

© 2025 Tiago Portilho – Free for personal and educational use.

SteamVault - Seu Companheiro Pessoal da Biblioteca Steam

SteamVault é um aplicativo desktop projetado para ajudá-lo a gerenciar e visualizar sua biblioteca de jogos Steam localmente. Ele lê seus jogos instalados, tempo de jogo e conquistas, e permite que você veja suas estatísticas — tudo armazenado localmente.

Prévia do SteamVault

Nota: Esta é uma ferramenta focada na privacidade. Nenhum dado sai da sua máquina.

Tecnologias Utilizadas:

	Node.js – Ambiente de execução backend
	SQLite + Prisma – Banco de dados local com ORM
	Vite – Ferramenta de build frontend
	Tauri – Framework de aplicativo desktop multiplataforma (Rust + JS)
	JavaScript – Linguagem de programação principal
Pacote	Tauri Bundle – Empacotamento e distribuição de aplicativos

Desenvolvedor:

Tiago Portilho

Principais Recursos:

Detecção de Jogos Steam (via API)
Lista de Jogos com Tempo de Jogo e Conquistas
Adicionar Guias Pessoais e Notas
Rastreador Offline da Biblioteca Steam
Banco de Dados Local (SQLite + Prisma)
Rápido e Leve (Tauri + Vite)

Instalação e Configuração

# Clonar o repositório
git clone https://github.com/TiagoPortilho/SteamVault.git

# Navegar para a pasta do projeto
cd SteamVault

# Instalar dependências
npm install

# Enviar o esquema do banco de dados
npx prisma db push

# Construir frontend
npm run build

# Executar o app em modo de desenvolvimento
npm run tauri dev

Dica: Você pode usar o script Python run.py para automatizar essas etapas.

Recursos Planejados / Roadmap

Modo Idle do Steam – Simular o jogo rodando para farmar cartas de troca do Steam
Auto-Scan Local Completo – Buscar automaticamente todos os jogos Steam sem entrada do usuário (análise de arquivos em vez de API)
Base de Framework – Transformar o SteamVault em um template base para outros apps com arquitetura similar (Tauri + Vite + Prisma)
Gerenciador de Backup de Saves de Jogos – Fazer backup e restaurar arquivos de save de jogos facilmente

Licença

Este projeto está licenciado sob a Licença MIT.

© 2025 Tiago Portilho – Gratuito para uso pessoal e educacional.

Name		Name	Last commit message	Last commit date
prisma		prisma
public		public
src-tauri		src-tauri
src		src
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
index.html		index.html
package-lock.json		package-lock.json
package.json		package.json
run.py		run.py
vite.config.js		vite.config.js

Latest commit

History

Folders and files

Repository files navigation

SteamVault - Your Personal Steam Library Companion

SteamVault preview

Quick Start

For Users (Download & Install)

For Developers (Build from Source)

Technologies Used:

Developer:

Key Features:

Requirements

For Users:

For Developers:

Configuration

Project Structure

Development

Available Scripts

Database

Privacy & Security

Planned Features / Roadmap

Contributing

Development Setup

Support

License

SteamVault - Seu Companheiro Pessoal da Biblioteca Steam

Prévia do SteamVault

Início Rápido

Para Usuários (Download & Instalação)

Para Desenvolvedores (Compilar do Código)

Tecnologias Utilizadas:

Desenvolvedor:

Principais Recursos:

Requisitos

Para Usuários:

Para Desenvolvedores:

Configuração

Estrutura do Projeto

Desenvolvimento

Scripts Disponíveis

Banco de Dados

Privacidade e Segurança

Recursos Planejados / Roadmap

Contribuição

Configuração de Desenvolvimento

Suporte

Licença

Installation & Setup

Planned Features / Roadmap

License

SteamVault - Seu Companheiro Pessoal da Biblioteca Steam

Prévia do SteamVault

Tecnologias Utilizadas:

Desenvolvedor:

Principais Recursos:

Instalação e Configuração

Recursos Planejados / Roadmap

Licença

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages