PlayCount 🎮

PlayCount is a powerful plugin for the Steam Deck that displays real-time player counts for your Steam games. Stay informed about the active player base of any game in your library or while exploring the Steam Store. Enhance your gaming decisions with data at your fingertips! 👥

---

✨ Features

Display Features

• Real-Time Data: View live player counts for your Steam Library games
• Steam Store Integration: Displays live player counts directly on Steam Store pages
• User-Friendly Interface: Clean, minimal, and non-intrusive design
• Animated Counter: Smooth number transitions when player counts update
• Custom Icons: Choose from multiple icon styles (dot, signal, wifi, globe, users, gamepad, power)
• Position Options: Place the badge in different locations (top-right, top-left)
• Color-Coded Status: Different colors based on player count ranges (platinum, gold, silver, bronze)

Advanced Statistics

• Detailed Analysis: View comprehensive player statistics including:
  • Current player count
  • 24-hour peak
  • 7-day and 30-day averages
  • Historical trends
  • All-time peak with date
• Trend Analysis: Advanced metrics including:
  • Volatility scoring
  • Stability analysis
  • Growth predictions
  • Hourly trends
  • Weekend vs. weekday patterns

Customization Options

• Badge Customization:
  • Adjustable size
  • Rounded or sharp corners
  • Custom colors for badge and text
  • Show/hide "Online" text
  • Multiple icon options
• Store Display Settings:
  • Adjustable text size
  • Customizable position
  • Vertical alignment options
  • Show/hide "Online" text
  • Icon selection

Interactive Features

• Click Actions:
  • Quick access to detailed stats modal
  • Direct link to SteamCharts (Ctrl+Click)
  • Interactive charts and graphs
• Cached Data: Efficient data storage to reduce API calls

---

📸 Screenshots

Game Library View

Store Page Integration

Advanced PlayCount Stats

Settings

---

🚀 Installation

Method 1: Decky Store (Recommended)

1. Install Decky Loader.
2. Open the Decky Store (🛒) from the Quick Access Menu on your Steam Deck.
3. Search for "PlayCount."
4. Click Install and restart Decky Loader.

Method 2: Manual Installation

1. Install Decky Loader.
2. Download the latest release from the PlayCount GitHub Releases.
3. Extract the downloaded file.
4. Move the extracted folder to /homebrew/plugins/.
5. Restart Decky Loader.

---

🛠️ Development

Prerequisites

• Node.js 16 or higher
• pnpm (a fast, disk space-efficient package manager)
• Steam Deck or Desktop environment with Decky Loader installed

Building from Source

1. Clone the repository:

   git clone https://github.com/itsOwen/playcount-decky.git
   cd playcount-decky

2. Install dependencies:

   pnpm install

3. Build the plugin:

   pnpm run build

After building, you can manually move the plugin files to /homebrew/plugins/ on your Steam Deck.

---

🤝 Contributing

We welcome contributions from the community!

How to Contribute

1. Fork the repository.
2. Create a new feature branch:

   git checkout -b feature/YourFeature

3. Commit your changes:

   git commit -m "Add YourFeature"

4. Push your branch:

   git push origin feature/YourFeature

5. Open a Pull Request on GitHub.

For major changes, please open an issue to discuss your ideas first.

---

🐛 Known Issues

• No current issues reported.
• If you encounter any bugs, please open an issue.

---

📝 License

This project is licensed under the BSD-3-Clause License. See the LICENSE file for more details.

---

🌟 Credits

Special thanks to the following contributors and resources:

• OMGDuke
• JtdeGraaf
• eXhumer
• FrogTheFrog
• TrainDoctor
• Decky Loader

---

📱 Connect with Me

---

💖 Support the Project

If you find PlayCount helpful, consider supporting the project:

• ⭐ Star the repository
• 🐛 Report bugs
• 💡 Suggest new features
• 🤝 Contribute to the code

Let's build something awesome together!