itchio / itch

🎮 The best way to play your itch.io games
https://itch.io/app
MIT License
2.35k stars 209 forks source link

Clarify docs: butler is under `apps/` *only* if explicitly installed #2299

Open fasterthanlime opened 5 years ago

fasterthanlime commented 5 years ago

See https://github.com/itchio/itch/issues/2273#issuecomment-496928399

It is unclear in the docs, hence, that's a bug and the docs need to be fixed.

fluffy-critter commented 4 years ago

I just installed the Itch app on a new machine and was running into that problem. It'd be nice if the docs said something like "After installing butler using the app, [...]" or something, especially since butler used to just be installed automatically (as far as I recall anyway).

brettchalupa commented 1 month ago

I just ran into this issue. I read the docs and thought butler was bundled with the itch app and that I was supposed to use that, saw ~/LibraryApplication\ Support/itch/apps was empty, and ended up on realizing you have to install butler from the itch app. Here's a suggestion for updated text on https://itch.io/docs/butler/installing.html.

Change:

Better yet, you can install it using the itch app, so it stays up-to-date.

To be:

Better yet, install the itch app and then install butler by searching for it and installing it through the itch app. This will automatically keep butler up-to-date!