StatsForSteam

Steam Library Analytics Tool - Analysiere deine Steam-Spielbibliothek und erhalte interessante Einblicke in dein Spielverhalten.

🚀 Setup

1. Dependencies installieren

pip install -r requirements.txt

2. Steam API Key beantragen

1. Gehe zu: https://steamcommunity.com/dev/apikey
2. Logge dich mit deinem Steam-Account ein
3. Gib einen Domain-Namen ein (z.B. localhost für lokale Entwicklung)
4. Kopiere deinen API Key

3. .env Datei erstellen

Kopiere .env.example zu .env und füge deinen API Key ein:

cp .env.example .env

Öffne .env und setze deinen Key:

STEAM_API_KEY=dein_api_key_hier
DEFAULT_STEAM_ID=deine_steam_id_hier  # Optional

4. Steam ID finden

1. Gehe zu: https://steamid.io/
2. Gib deine Steam Profil-URL ein
3. Kopiere die steamID64 (17-stellige Zahl)

🎮 Verwendung

Phase 1 Test (CLI)

python main.py

Gibt Eingabeaufforderung für Steam ID und zeigt Profil-Übersicht an.

📁 Projekt-Struktur

StatsForSteam/
├── config/              # Konfiguration & Settings
│   └── config.py
├── api/                 # Steam API Integration
│   ├── steam_client.py  # API Client mit Rate-Limiting
│   └── endpoints.py     # Endpoint-Definitionen
├── data/                # Datenmodelle & Fetching
│   ├── models.py        # Pydantic Models
│   └── fetcher.py       # Daten-Aggregation
├── cache/               # API Response Cache (auto-generiert)
├── main.py              # Entry Point
├── requirements.txt     # Python Dependencies
└── .env                 # Environment Variables (nicht committen!)

🔧 Features (Phase 1)

✅ Steam API Integration mit Rate-Limiting
✅ Automatisches Response-Caching
✅ Retry-Logic bei Fehlern
✅ Spielbibliothek abrufen
✅ Profil-Daten & Statistiken
✅ Top 10 meistgespielte Spiele
✅ Kürzlich gespielte Spiele
✅ Basic Fun Facts

📊 Geplante Features

Phase 2-4

• 📈 Detaillierte Zeitanalysen
• 💰 Wirtschaftliche Analysen (Preis/Stunde)
• 🏆 Achievement-Tracking
• 📊 Interaktives Dashboard (Streamlit)
• 📉 Genre-Visualisierungen
• 🎯 Hidden Gems Finder

⚠️ Wichtige Hinweise

Privatsphäre

• Dein Steam-Profil muss öffentlich sein
• Spielbibliothek muss öffentlich sichtbar sein
• Einstellungen unter: Profil → Bearbeiten → Privatsphäre-Einstellungen

API Limits

• Steam erlaubt ca. 200 Requests pro 5 Minuten
• Der Client hat automatisches Rate-Limiting
• Cache reduziert API-Calls (24h Gültigkeit)

Datenschutz

• API Key ist privat - niemals teilen oder committen!
• .env ist in .gitignore - wird nicht versioniert
• Cache-Daten sind lokal gespeichert

🐛 Troubleshooting

"Keine Spiele gefunden"

→ Prüfe Profil-Privatsphäre-Einstellungen

"Ungültiger API Key"

→ Überprüfe .env Datei und API Key

"Rate-Limit erreicht"

→ Warte 5 Minuten, Cache nutzt alte Daten

Steam ID Format-Fehler

→ Verwende steamID64 (17 Stellen), nicht vanity URL

📚 Nützliche Links

• Steam Web API Docs: https://partner.steamgames.com/doc/webapi
• Steam API Key: https://steamcommunity.com/dev/apikey
• Steam ID Finder: https://steamid.io/
• Inoffizielle API Docs: https://steamapi.xpaw.me/

🤝 Entwicklung

Projekt für Informatik Abschlussarbeit - Steam Library Analytics

Aktueller Status: Phase 1 abgeschlossen ✅

---

Made with ❤️ for Steam Gamers