youtube2mp3 - quick install guide
==================================
Save any YouTube video as MP3 (audio) or MP4 (video) with one click in Chrome.
Free. Website: https://smartapz.com/youtube2mp3

It has two small parts: a Chrome extension (the button) and a helper
program on your computer (does the actual download). Setup takes ~5 minutes.


WINDOWS 10 / 11
---------------
1. Press Win+X and click "Terminal" (or "Windows PowerShell").

2. Paste this line and press Enter:

   irm https://smartapz.com/youtube2mp3/install.ps1 | iex

   It downloads youtube2mp3, checks it, and installs everything it
   needs (Python if missing, yt-dlp, ffmpeg). Works with Smart App
   Control on. Wait until it says "All set". It then opens Chrome's
   Extensions page (if not, type chrome://extensions in Chrome).

3. In Chrome (chrome://extensions):
   - turn on "Developer mode" (top right)
   - click "Load unpacked", click the folder box at the top, press
     Ctrl+V and Enter, then "Select Folder". (The installer copied the
     folder path: %LOCALAPPDATA%\youtube2mp3\extension)
   - click the puzzle-piece icon and pin "youtube2mp3".
   Already added it before? Just click the reload arrow on its card.

Other ways to install on Windows:
 - youtube2mp3-setup.exe from https://smartapz.com/youtube2mp3 . It is
   not signed: Windows may say "Windows protected your PC" - click
   "More info" > "Run anyway". With Smart App Control ON the .exe is
   blocked; use the one line above instead. Then do step 3.
 - Manual (zip): download youtube2mp3.zip, right-click > Extract All.
   Open the extracted folder, click the address bar, type powershell,
   press Enter and paste these 2 lines (they work from either the outer
   or the inner youtube2mp3 folder):

   Get-ChildItem -Recurse | Unblock-File
   powershell -ExecutionPolicy Bypass -File (Get-ChildItem -Recurse -Filter install-windows.ps1 | Select-Object -First 1).FullName

   Then do step 3.

If Windows says "Smart App Control has blocked part of this app", you
can ignore it as long as downloads work.


MAC / LINUX
-----------
1. Unzip youtube2mp3.zip, open Terminal and run:
      cd ~/Downloads/youtube2mp3
      bash install.sh
   It downloads everything it needs. If it says Python is missing,
   install Python 3 from python.org and run it again.
2. In Chrome: chrome://extensions > Developer mode > Load unpacked >
   Mac:   ~/Library/Application Support/youtube2mp3/extension
   Linux: ~/.local/share/youtube2mp3/extension
   (On Mac, press Cmd+Shift+G in the folder window to paste the path.)
3. Pin "youtube2mp3".


HOW TO USE
----------
Open a YouTube video > click the youtube2mp3 icon > choose MP3 (audio)
or MP4 (video, up to 1080p) > click Download.
The file appears in your Downloads folder. You can close the popup
while it works; you'll get a notification when it's done.
You can also right-click a YouTube page or link > "Download MP3/MP4".


UPDATES
-------
When a new version is out, the popup shows "Update available".
Click "Update now" - that's it.

The helper also updates yt-dlp by itself once a day, and right away
when YouTube refuses a download (then it retries once).
If something still stops working (YouTube changes often): paste the
one line from step 2 again (Mac/Linux: bash install.sh), then in
chrome://extensions click the reload arrow on the youtube2mp3 card.
Tip: downloading dozens of videos in a row may make YouTube slow you
down for a while. That's temporary.


PLEASE NOTE
-----------
For personal use only. Download only content you own or have the
right to save. Downloading may be against YouTube's Terms of Service.
Not affiliated with YouTube or Google.

Free to use, no warranty - use at your own risk (MIT License, see
LICENSE.txt). (c) 2026 SmartApz - https://smartapz.com
