Skip to content

usr-wwelsh/Itch.io-Console-Mode

Repository files navigation

Itch.io Console Mode

A modern, console-style browser for itch.io's free HTML5 games. Features a sleek terminal inspired UI with smooth swipe navigation and keyboard controls.

Screenshot 2025-10-25 150505

Features

  • 🎮 Browse hundreds of free HTML5 games from itch.io
  • 🔥 Smooth swipe navigation - swipe distance = cards jumped
  • ⌨️ Full keyboard navigation support
  • 🎨 Console-inspired dark theme
  • 📦 Tag-based filtering by genre
  • ⭐ Favorites and recently played tracking
  • 🚀 Fast performance with smart caching

How It Works

This app uses publicly available RSS feeds from itch.io to discover and display free HTML5 games. When you select a game, it opens the game on itch.io's platform - supporting creators and respecting their work.

No web scraping. No API abuse. Just RSS feeds and links.

Data Source

The app loads game data from itch.io's public RSS feeds:

  • https://itch.io/games/genre-action/platform-web.xml
  • https://itch.io/games/tag-platformer.xml
  • And more...

XML feeds are cached locally for faster loading.

Installation

# Clone the repository
git clone https://github.com/yourusername/1itchConsole.git
cd 1itchConsole

# Install dependencies
npm install

# Start development server
npm run dev

Building for Production

npm run build
npm run preview

Tech Stack

  • React 19 - UI framework
  • Vite - Build tool
  • Tailwind CSS 4 - Styling
  • localStorage - Client-side caching

Swipe Navigation

The app features distance-based swipe jumping:

  • Small swipe → 1 card
  • Medium swipe → 2-3 cards
  • Large swipe → 5+ cards

Perfect for quickly browsing through large game lists!

Legal & Attribution

  • All games are hosted on itch.io and owned by their respective creators
  • This is an unofficial browser client - not affiliated with itch.io
  • Games open directly on itch.io to support creators
  • Uses publicly available RSS feeds for game discovery
  • Full disclaimers displayed in the app

Contributing

Contributions welcome! Please open an issue before submitting major changes.

License

MIT License - See LICENSE file for details

Acknowledgments

  • Thanks to the amazing indie developers on itch.io
  • Inspired by game console UIs and terminal aesthetics

Note: If you want to use this project, you may need to download RSS feeds yourself or implement a feed fetcher. The included feeds are snapshots and may become outdated.

About

A modern, console-style browser for itch.io's free HTML5 games.

Topics

Resources

Stars

Watchers

Forks