Feature rich command-line music player for Windows OS (Tested on Win10 only*).
Can play songs of supported file types and perform basic music control operations
.wav formats don't support seeking
Do not install this program directly before going through these steps in order if you are new to git, python wheels and setting up virtual environments using virtualenv
You first need to install a python version < 3.10** from www.python.org
Make sure to check the "Add python to PATH" checkbox in the python installer before starting installation...
If you have it installed already, skip directly to Step 4
Visit this site and download git for your system...
Once downloaded, run the git installer with default settings...
Restart your terminal window for git to become available to it...
There is a new kind of quick-setup (for Windows OS Only)... via the "INSTALLATION.py" file. Click here to download.
It allows you to single-handedly download and setup this entire music player quickly and easily
To try out this new easy way of installation, follow the steps given here...
Open up a cmd or terminal window
Step 3.1: cd (or sl if using powershell) to the directory where you want to install the music player folder (any desired location is fine...)
Step 3.2: Run: git clone https://github.com/Vivojay/mariana-music-player/
Step 3.3: cd to "mariana-music-player" dir (Our root folder/program folder...)
Run mkdir src
Run: move * src/. (Note: The period . is not to be excluded...) to move all files to src directory.
Step 3.4: Make a virtual environment with python virtualenv module by
running: py -m pip install virtualenv in the terminal window
After virtualenv is installed, type py -m virtualenv -p="<path_to_your_python_executable>" .virtenv
E.g. In my case, I had python 3.9.5 installed at location: "C:\Users\Vivo Jay\AppData\Local\Programs\Python\Python39\python.exe"
So I ran py -m virtualenv -p="C:\Users\Vivo Jay\AppData\Local\Programs\Python\Python39\python.exe" .virtenv
You may have your python installation done in a similar location, try for your own path and run the command...
In the same location run .\.virtenv\Scripts\activate and wait for a(.virtenv) prompt in your terminal, if this happens and you get no error, you have successfully activated your newly created virtualenv with the supported python version.
Step 3.5: Run: cd src (change location to src dir)
Step 3.6: Now, Install PyPI modules from pip using pip install -r requirements.txt (Wait for the installations to complete...)
Step 3.7: Run: py -m pip install git+https://github.com/Vivojay/pafy@develop
Step 3.8: Run: py -m pip install --no-cache-dir comtypes (Because comtypes throws errors on importing otherwise, see #244 in comtypes)
Now you need to install a release of ffmpeg from their official site at www.ffmpeg.org
Choosing an essential build should be enough, although you may choose to go for a full build while you're at it (you may need it for something else later...)
Once downloaded, extract the downloaded zip file to a known location (E.g. "C:\Users\Admin\Desktop")
Since the ffmpeg project build will be an archive of the '.7z' format, to unzip and extract it, you will need to install the 7zip archiver from the 7zip official site
Now copy the path to that directory (not the path of an extracted file itself) and add this to the system variables path (see here for a short tutorial)
Download VLC media player from their official site with the same architecture (32 or 64 bit) as your python version.
Architecture match between VLC and Python (v < 3.10) is critical for python-vlc binding to install properly.
This step explains an entirely useless installation procedure as of now.
The llvmlite wheel may only be required in the future, so you may decide to skip to Step 7 instead...
To continue with this step, you need to install a compatible version of the llvmlite wheel for python from this site
How to choose the right version of this wheel
Step 6.1: Choosing the version number
Step 6.2: Choosing the correct platform
Step 6.3: Run pip install <llvmlite_wheel_file_name>
(E.g. pip install llvmlite-0.37.0-cp39-cp39-win_amd64.whl)
Now run: py -m pip install librosa to install librosa (which is the reason we needed the llvmlite wheel in the first place).
The librosa module may help in bpm and key detection of songs in the future...
Now, you must restart your terminal for path variables (like ffmpeg) to refresh and take effect.
Step 7.1: That's it, setup is complete. Now just take a moment to go through the help.md file and get a look at the available commands and their syntax/usage rules...
Step 7.2: Finally, run your app either with or without command line flags (flags may be provided in the help.md, if not so, then flags have not yet been implemented and will not work)
This program uses the pygame module for playing and controlling songs stored locally.
It also uses the vlc module for playing and controlling songs streamed directly from the internet.
Pygame requires you to first initialize its mixer object by calling the init function pygame.mixer.init()
Then you can load a song with pygame.mixer.music.load( "path-to-file.ext" )
Finally to play, pause, mute, unmute, set volume, queue, and stop song
you can do it all using the pygame.mixer.music as follows:
pygame.mixer.music.play()pygame.mixer.music.pause()pygame.mixer.music.set_volume(0)pygame.mixer.music.set_volume(cached-volume-as-percentage)pygame.mixer.music.set_volume(desired-volume-as-percentage)pygame.mixer.music.queue('next_song')
First, a VLC instance is created with vlc.Instance()
E.g. player = vlc.Instance(), then we unset its logs to reduce the unnecessary output on screen when adding media to this player
i.e. player.log_unset()
Get some media streaming url like and pass it to player.media_new
E.g. media_streaming_url = "http://sa.mp3.icecast.magma.edge-access.net:7200/sc_rad41"
Then new media_list_new and MediaPlayer instances are created
and finally this media_list is inserted into the MediaPlayer
media = player.media_new(media_streaming_url)
media_list = player.media_list_new()
media_list.add_media(media)
vlc_media_player = player.media_list_player_new()
vlc_media_player.set_media_list(media_list)Now that vlc_media_player is created, we can control media via actions like play, pause, stop and resume.
To control the song positioning (seeking), we can get the media player object from vlc_media_player using
MPO = vlc_media_player.get_media_player()
with this MPO (object), we can access more song parameters
such as..
- get/set song position
- change track within playlist (skip/prev/next)
- get/set audio volume (audio_set_volume) etc...
- Follow all steps (1 to 7) except Step 3, in order...
i.e. Install Python (version < 3.10), git, VLC, FFMPEG (and optionally, the librosa wheel) - Restart all terminals
- Download ONLY the initsetup.py file (No other project files required)...
- Run it in console with command:
py "<absolute_path_to_py_file>"
E.g.py "C:\Users\Admin\Downloads\initsetup.py" - Follow the instructions provided...
Run main.py from command line (with desired arguments, for more details, ***look here).
Original Light version of lyrics displayer
New dark lyrics window + lyrics view
- Basic controls (mute, elapsed time, list library files, ...)
- Soft play/pause by default
- Colourful cheery interface
- Play random songs from library
- View prettified progress
- Absolute and relative seek
- Viewing, editing lyrics for downloaded songs (only offline lyrics are supported)
- View currently playing files (name or full path)
- Open currently playing files in windows file explorer
- View history of all played media in current session
- Listen to any one of 3 preprovided webradios
- View Reddit Sessions (Requires a Reddit API)
- Play directly from radio links and YouTube urls
- Play songs from direct YouTube searches
- Download songs and videos from YouTube
- Open currently playing YouTube media in browser (with synced timestamp...)
- Customisable via settings located in
settings/settings.yml
- Rarely: "ConnectionResetError": ... is shown on screen (non breaking)
- Very Rarely: "Segment fault pygame": ... breaking error
- Rarely: Random Thread Exception: ... is shown on screen (non breaking)
*Most features may work on Linux, but is still untested for any OS other than Win10...
**This player requires Python version < 3.10 (exclusive of 3.10 itself) and will not work otherwise, because there are currently no unofficial binaries available for the llvmlite wheel compatible with Python versions >= 3.10.
The llvmlite wheel is in turn required by the librosa module.
***Currently, this feature is unimplemented and there are no command line flags available yet... Also, interactive help documentation and an interactive loading throbber/print-statement need to be added.