Skip to content

codevski/gameta

Repository files navigation

📚 Gameta

Organise your games, your way

Gameta automatically organizes your Steam games into smart collections and fetches beautiful artwork from SteamGridDB. Built as a Decky plugin for Steam Deck, with plans for broader Steam client support.

✨ Features

  • Smart Collections - Automatically categorize games by genre (Horror, Adventure, RPG, etc.)
  • Beautiful Artwork - Fetch high-quality covers from SteamGridDB
  • Steam Deck Native - Seamless integration with Decky Loader
  • Zero Maintenance - Set it up once, let it handle the rest

🚀 Quick Start

  1. Install Decky Loader on your Steam Deck
  2. Download Libmeta from the plugin store
  3. Get your free SteamGridDB API key
  4. Configure and scan your library

🎮 How It Works

Your Huge Library → Gameta → Organized Collections + Beautiful Art

Gameta scans your Steam library, identifies game genres, creates themed collections, and downloads matching artwork. All automatically.

⚙️ Configuration

  • API Key: Add your SteamGridDB key in settings
  • Quality: Choose artwork resolution (High/Medium/Low)
  • Auto-Update: Keep collections fresh as you add games
  • Custom Genres: Override automatic categorization

🛠️ Development

# Clone the repository
git clone https://github.com/codevski/gameta.git
cd gameta

# Install dependencies
npm install

# Development mode
npm run dev

# Build for production
npm run build

📋 Requirements

  • Steam Deck with Decky Loader installed
  • SteamGridDB account (free)
  • Internet connection for artwork downloads

🗂️ Supported Collection Types

  • Genre-Based: Horror, Adventure, Action, RPG, Strategy, Simulation
  • Developer Collections: Group games by studio
  • Year Collections: Organize by release decade
  • Custom Tags: Create your own categories

🎨 Artwork Sources

All artwork is sourced from SteamGridDB, the community-driven database of high-quality Steam game artwork.

🤝 Contributing

Contributions welcome! Please read our Contributing Guide first.

  • 🐛 Report bugs via Issues
  • 💡 Request features via Discussions
  • 🔧 Submit PRs for improvements

📄 License

MIT License - see LICENSE for details.

🙏 Credits


Made with ❤️ for Steam Deck users who love organization

About

Organise your games, your way

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published