zenmp3/howto_install.md

How to install ZenMP3 on a variety of platforms

Note: you must have Python version 2.7 or newer in order to run ZenMP3. While this may be a standard in UNIX-like operating systems, very few Windows machines and only recent Mac OS X versions ship with it installed, so take care of it before you proceed.

Note: youtube-dl is under constant updating to match the YouTube API. I recommend you to update it every week or so for ZenMP3 to work correctly.

GNU/Linux and other UNIX-like distributions

Unfortunately, there are simply too many package managers for one to be able to feature detect and automate the installation process in a Linux distribution. Instead, here's the datailed procedure:

1. Use your distribution's package manager to download and install the following packages:

*ffmpeg (in Ubuntu, install avconv instead) *youtube-dl

1. git clone https://notabug.org/kzimmermann/zenmp3.git
2. Run the install_unix.sh script, located in src

With sufficient permissions in the machine, you can now run ZenMP3 by typing the command zenmp3, or running it from the applications menu.

Mac OS X Snow Leopard and newer

Since the newer Macs are standardized in the shell-level, Mac users can benefit from a single installation script. To install ZenMP3 on a Mac:

1. Open a Terminal window.
2. Type svn checkout http://zenmp3.googlecode.com/svn/trunk/ zenmp3-latest and press Enter
3. Type cd zenmp3-latest and press Enter
4. Type bash install_mac.sh and press Enter
5. Follow the instructions that are prompted.

This will download all dependencies and install ZenMP3. To run ZenMP3, open a Terminal and type zenmp3.

Windows

Is unsupported. Recent privacy-threatening developments with Windows 10 and overall Microsoft evildoing has had me drop any support whatsoever from this platform.

While ZenMP3 may still run quite well on Windows (I've tested it myself some years ago), I will provide no more support on installing or porting it.

Hack and fork ZenMP3 at will - that's what the GPL is for - but I myself won't be developing anything for Windows ever again..