Skip to content

Conversation

@itsaivivek
Copy link

Description

This PR improves the README.md to make the setup process much clearer and more beginner-friendly, especially for Linux users.

Main changes:

  • Added explicit step-by-step instructions for enabling USB debugging on Android device
  • Clarified how to download the audiosource script from releases and make it executable
  • Added a dedicated Troubleshooting section for the very common "Error: adb not found" issue
    • Specifically includes solution for Linux Mint / Ubuntu-based distributions using apt
  • Improved wording, flow, and structure of Installation & Usage sections
  • Added note about granting microphone permission on Android

These changes should significantly reduce friction for new users trying to set up Audio Source, especially those running into ADB-related problems.

Related issues

None (preventive improvement)

Testing

  • Verified the written steps work on Linux Mint
  • Instructions match current release assets structure

Thank you for considering this contribution!

gdzx added a commit that referenced this pull request Jan 16, 2026
Co-authored-by: itsaivivek <er.vivek.social@gmail.com>
@gdzx
Copy link
Owner

gdzx commented Jan 17, 2026

Hi!

Thanks for your PR. There are some formatting issues such as hard line breaks so I cannot merge it as-is, but I copied most of the changes in next.

Best regards

gdzx added a commit that referenced this pull request Jan 17, 2026
Co-authored-by: itsaivivek <er.vivek.social@gmail.com>
gdzx added a commit that referenced this pull request Jan 17, 2026
Co-authored-by: itsaivivek <er.vivek.social@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants