https://github.com/splitbrain/itchy
Fetch your itch.io library into an sqlite database for easier searching
https://github.com/splitbrain/itchy
cli itch-io itchio php
Last synced: 6 months ago
JSON representation
Fetch your itch.io library into an sqlite database for easier searching
- Host: GitHub
- URL: https://github.com/splitbrain/itchy
- Owner: splitbrain
- License: mit
- Created: 2022-03-04T19:24:37.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2022-03-04T21:20:11.000Z (over 3 years ago)
- Last Synced: 2025-03-29T01:01:44.642Z (6 months ago)
- Topics: cli, itch-io, itchio, php
- Language: PHP
- Homepage:
- Size: 10.7 KB
- Stars: 7
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# itchy - scratches an itch with itch.io
When you buy bundles at itch.io to support good causes you end up with a huge library of all kinds of stuff. Finding what you are interested in, is hard. Because itch.io's client and website have no simple was to search and filter your own library.
This command line PHP tool scratches that itch. It will download all available information from itch.io, store it in a database and let you search through the contents.
## Installation
1. clone this repository
2. install the dependencies `composer install`
## Filling the database
Get an API key from https://itch.io/user/settings/api-keys then run the `update` command:
```
./itchy.php update
```
## Searching
Use the search command. Giving no arguments will show you whole library:
```
./itchy.php search
```
You can use the `-f` parameter to show longer descriptions
```
./itchy.php search -f
```
Give search terms as arguments
```
./itchy.php search -f witch punk
```
Prefix terms with `+` or `-` to include or exclude tags
```
./itchy.php search -f witch punk +tag-horror -tag-ttrpg
```