search

beetbox / beets

music library manager and MusicBrainz tagger
http://beets.io/
MIT License
12.56k stars 1.8k forks source link

Adding a 'Beginner Friendly CLI" version of the Getting Started Guide #5259

Open skylarposler opened 1 month ago

skylarposler commented 1 month ago

Discussed in https://github.com/beetbox/beets/discussions/5258

Originally posted by **skylarposler** May 24, 2024 Proposal: Creating a ‘Beginner Friendly CLI Getting Started Guide’ with more in-depth step by step instructions and screenshots to help eliminate errors upon installation and configuration, will help more inexperienced CLI users navigate and set up beets correctly. Result: To make beets more available to beginner CLI users.
khrystianc commented 1 month ago

If no one has started or done this, I would like to work on a product for this issue resolution.

skylarposler commented 1 month ago

Hi! I'm currently working on the windows version of this. If you would like, the MacOS could benefit from this as well.

khrystianc commented 1 month ago

Thank you for getting back to me so quickly. This issue is all yours. I am working under windows as well.

RollingStar commented 2 weeks ago

Thank you! I just gave it a very light skim but being accessible to non-command-line users should help our reach tremendously.

I can't find where I suggested it, but I think "editable" (running from python source .py files) should be our default/preferred/only way of running beets in the documentation.

https://beets.readthedocs.io/en/stable/faq.html#run-the-latest-source-version-of-beets

It encourages new users to become new developers of light features/bug fixes, and encourages understanding how beets works.