Skip to content

clawssh/Steam-Idler

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎮 Steam Idler - Smart & Interactive

A smart Steam idling application with a database backend and interactive console interface that automatically detects when you're playing games and intelligently switches between your VPS and main system. No more conflicts between systems!

🚀 Quick Start (Super Easy!)

  1. Install dependencies:

    npm install
  2. First-time setup:

    npm run setup

    Just follow the prompts - it's that simple!

  3. Start the interactive interface:

    npm start

🎯 What's New in v2.0

Database Backend - SQLite database stores all configuration securely
Interactive Console - Beautiful menu-driven interface
Game Search - Search and add games by name or app ID
Smart Game Detection - Automatically detects when you're playing
Auto-Switching - Stops idling when gaming, resumes when not
VPS Friendly - Perfect for idling on VPS while gaming on main PC

🔧 How It Works

The Steam Idler provides an interactive console interface where you can:

  • Search for games by name or app ID
  • Add/remove games with simple menu selections
  • Configure settings through interactive prompts
  • Monitor idling status in real-time
  • Auto-detect games running on your system

🎮 Interactive Features

Main Menu

  • 🚀 Start Idling - Begin idling configured games
  • ⏸️ Stop Idling - Stop current idling session
  • 🔍 Search & Add Games - Find and add games to idle
  • 📝 List Games - Show all configured games
  • 🗑️ Remove Games - Remove games from idling list
  • ⚙️ Settings - Configure auto-restart and game detection
  • Help - Show help information
  • 🚪 Exit - Close the application

Game Search

  • Search by game name (e.g., "CS2", "Dota")
  • Search by app ID (e.g., "730", "570")
  • Auto-completion with popular games
  • Easy selection from search results

Smart Detection

  • When games are detected: Automatically stops idling
  • When games stop: Resumes idling automatically
  • Cross-platform: Works on Windows, Linux, and macOS
  • Configurable: Adjust detection intervals

📱 Popular Game IDs

Game App ID
CS2 730
Dota 2 570
Team Fortress 2 440
GTA V 271590
Rust 252490
PUBG 578080

🛠️ Commands

npm start              # Start interactive interface
npm run setup          # Configure username, password, and settings
npm run help           # Show detailed help

💡 Pro Tips

  • Run setup once, then just use npm start
  • Use the search function to find games easily
  • Perfect for VPS idling while gaming on main PC
  • No manual intervention needed - it's completely automatic
  • All settings stored in database - persistent configuration

🔒 Security & Data

  • SQLite database stores configuration securely
  • Passwords encrypted and stored locally
  • Refresh tokens for automatic reconnection
  • No external data transmission
  • Open source and transparent

🌟 Perfect For

  • VPS Users - Idle games on your VPS without conflicts
  • Gamers - Automatically manage idling around your gaming sessions
  • Power Users - Advanced configuration through interactive menus
  • Beginners - Simple setup and guided interface

📋 Requirements

  • Node.js 14.0.0 or higher
  • Steam account
  • Internet connection

🚨 Troubleshooting

Steam Guard required? - Just enter the code from your authenticator during setup
Connection issues? - The auto-restart feature will handle reconnections
Games not detected? - Check that game detection is enabled in settings
Database issues? - The app will automatically create and initialize the database

📁 File Structure

steam-idler/
├── steam-idler.js      # Main application with interactive interface
├── package.json        # Dependencies and scripts
├── README.md          # This file
├── database/          # Database files
│   ├── db.sql        # Database schema
│   └── steam-idler.db # SQLite database (created automatically)

Made with ❤️ for the Steam community

Interactive console interface with database backend - the smart way to idle!

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published