{"id":25654092,"url":"https://github.com/zainibeats/idlemon","last_synced_at":"2025-02-23T20:17:22.462Z","repository":{"id":271040541,"uuid":"911900521","full_name":"zainibeats/idlemon","owner":"zainibeats","description":"Your desktop companion that rewards productivity with shiny Pokémon ✨","archived":false,"fork":false,"pushed_at":"2025-02-13T09:48:27.000Z","size":103784,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-13T10:33:28.459Z","etag":null,"topics":["idle-game","incremental-game","open-source","pokemon","python","retro-gaming","shiny-hunting"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zainibeats.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-04T06:16:04.000Z","updated_at":"2025-02-13T09:45:41.000Z","dependencies_parsed_at":"2025-02-10T03:33:52.789Z","dependency_job_id":null,"html_url":"https://github.com/zainibeats/idlemon","commit_stats":null,"previous_names":["mixoploidy8031/pokemonauto-hunt_v0.1.0","mixoploidy8031/idlemon","zainibeats/idlemon"],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zainibeats%2Fidlemon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zainibeats%2Fidlemon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zainibeats%2Fidlemon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zainibeats%2Fidlemon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zainibeats","download_url":"https://codeload.github.com/zainibeats/idlemon/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240371756,"owners_count":19790888,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["idle-game","incremental-game","open-source","pokemon","python","retro-gaming","shiny-hunting"],"created_at":"2025-02-23T20:17:21.970Z","updated_at":"2025-02-23T20:17:22.431Z","avatar_url":"https://github.com/zainibeats.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# IdleMon - Automated Shiny Hunting Simulator\n\nThis project simulates encountering Pokémon with a chance of finding shiny Pokémon. It features animated GIFs for Pokémon encounters, shiny tracking, encounter statistics, and customization options.\n\n\u003e **Note:** Looking for the Linux version? Check out the [Linux branch](https://github.com/zainibeats/idlemon/tree/linux)\n\n![icon](assets/images/icon_png.png)\n\n## Features\n- **Encounter simulation:** Displays Pokémon with their respective rarities\n- **Shiny hunting:** Tracks total shinies found with a 1/2000 chance\n- **Animated sprites:** Shows normal and shiny Pokémon as animated GIFs\n- **Statistics tracking:** \n  - Real-time encounter counter (resets after continuing from a shiny)\n  - Time elapsed tracker\n  - Total shinies found counter\n- **Sound effects:** \n  - Shiny encounter notification\n  - Continue button confirmation\n  - Optional muting through config\n- **User-friendly customization:** Easily configure settings through a simple config.json file - no coding required!\n  - Choose your own background image\n  - Toggle sound effects on/off\n\n![screenshot of shiny gyrados encounter](assets/images/screenshot_gyra.png)\n\n---\n\n## Requirements\nFor building from source:\n- Python 3.8 or later\n- Required libraries listed in requirements.txt\n\nInstall dependencies:\n```bash\n# Using pip (Windows/Linux)\npip install -r requirements.txt\n\n# Or if you have multiple Python versions\npython -m pip install -r requirements.txt\n```\n\n---\n\n## Usage\n\n### Windows Portable Version\n1. Download the latest release\n2. Extract the zip file anywhere you like\n3. Run `IdleMon.exe` from the extracted folder\n\nThe application is fully portable:\n- Can be run from any location\n- All data is stored in the application folder\n- No installation required\n- No system modifications\n\n### Building from Source (Windows)\n1. Clone the repository\n2. Install dependencies:\n   ```bash\n   python -m pip install -r requirements.txt\n   ```\n3. Build the executable:\n   ```bash\n   pyinstaller main.spec\n   ```\n4. The portable version will be created in `dist/IdleMon`\n\n---\n\n## Configuration\nThe simulator can be customized using a `config.json` file placed in the same folder as the executable:\n\n### Example `config.json`\n```json\n# Using absolute path:\n{\n    \"background_image\": \"C:/Users/YourName/Pictures/custom_background.png\",\n    \"mute_audio\": false\n}\n\n# OR using relative path (relative to IdleMon.exe):\n{\n    \"background_image\": \"assets/images/my_background.jpg\",\n    \"mute_audio\": false\n}\n```\n\n### Key Settings\n- **`background_image`:** Path to background image. Can be:\n  - Absolute path (e.g., \"C:/Users/YourName/Pictures/custom_background.png\")\n  - Relative path from IdleMon.exe (e.g., \"assets/images/my_background.jpg\")\n  - Defaults to included background if not found\n- **`mute_audio`:** Set to `true` to disable all sound effects (default: `false`)\n\n### Portable Directory Structure\n```\nIdleMon/\n├── IdleMon.exe\n├── assets/\n│   ├── gifs/\n│   │   ├── gen1/\n│   │   │   ├── normal/\n│   │   │   └── shiny/\n│   │   ├── gen2/\n│   │   │   ├── normal/\n│   │   │   └── shiny/\n│   │   ├── gen3/\n│   │   │   ├── normal/\n│   │   │   └── shiny/\n│   │   ├── gen4/\n│   │   │   ├── normal/\n│   │   │   └── shiny/\n│   │   └── gen5/\n│   │       ├── normal/\n│   │       └── shiny/\n│   ├── sounds/\n│   │   ├── shiny_sound1.wav\n│   │   └── continue_sound1.wav\n│   ├── data/\n│   │   ├── gen1_pokemon_names.txt\n│   │   ├── gen2_pokemon_names.txt\n│   │   ├── gen3_pokemon_names.txt\n│   │   ├── gen4_pokemon_names.txt\n│   │   └── gen5_pokemon_names.txt\n│   └── images/\n│       └── background.png\n├── config.json (optional)\n└── logs/      (created automatically)\n    ├── shiny_count.bin\n    ├── shinies_encountered.txt\n    └── error.log\n```\n\n---\n\n## Features Guide\n\n### Encounter System\n- Each encounter has a chance of being shiny (1/2000 by default)\n- When a shiny is found:\n  1. The encounter animation changes\n  2. A sound plays (if not muted)\n  3. The encounter count remains displayed\n  4. A continue button appears\n- After pressing continue:\n  1. The encounter counter resets to 0\n  2. A new hunting session begins\n\n### Sound System\n- Shiny encounters trigger a special sound effect\n- Continue button plays a confirmation sound\n- Optional muting through config.json\n\n### Statistics Tracking\n- Real-time encounter counter (resets after continuing from a shiny)\n- Elapsed time tracker\n- Total shiny Pokémon found\n- Automatic data saving for shiny counts\n\n### Resetting Progress\nTo reset your hunting progress, you can either:\n\nDelete individual files:\n1. Navigate to the `logs` directory in your IdleMon folder\n2. Delete these files:\n   - `shiny_count.bin` (resets total shinies to 0)\n   - `shinies_encountered.txt` (clears shiny encounter history)\n\nOR\n\nSimply delete the entire `logs` directory.\nNew files will be automatically created when you next run the program.\n\n---\n\n## Troubleshooting\n- **Missing GIFs:** Ensure GIF files exist in the correct generation's normal/shiny directories\n- **Animation Issues:** Verify GIF files are properly formatted\n- **Sound Problems:** Check that sound files exist in the assets/sounds directory\n- **Background Image:** Ensure the specified path exists and is accessible\n- **config.json:** Ensure the config.json file is correctly formatted and all paths are valid\n\n---\n\n## License\nThis project is licensed under the MIT License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzainibeats%2Fidlemon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzainibeats%2Fidlemon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzainibeats%2Fidlemon/lists"}