jakym 0.4.0

Just Another Konsole YouTube-Music

Just Another Konsole YouTube-Music

Overview

My motivation for creating jakym comes because I wanted to create an application that I could use to play music comfortably from the command line. I often play games and listen to music simultaneously but using either Spotify or playing music in a browser takes much-needed resources from my CPU and RAM.

I have spent a lot of time looking through numerous CLI based music players. But they either required setting up lots of things or needed premium features to function and sometimes flat out didn't work, even after tinkering for hours. Hence, instead of looking for a solution, I thought that I could code it myself.

So I present to you JAKYM, Just Another Konsole YouTube-Music.A command line based Youtube music player written in Python with both Spotify and Youtube playlist support and easy on memory.

Usage

Using Command Line Options

• Run the program by using jakym command jakym.You can also specify arguments to easily play a playlist or song. The available options can be seen via jakym -h
• Use jakym -s "link" or jakym -y "link" to instanly start up by queuing a playlist without having to use the command window.
• You can also use jakym -p "song 1" "song 2" "song 3" to queue up multiple songs.
• To instanty queue a saved jakym playlist run jakym -l playlistpath playlistname.
• This will launch into jakym command window.

Using Jakym Command Window

• The program opens up into the jakym command window.
• Use commands to view all available commands.
• Enter a songname in command window to search for song or just enter its youtube link to play directly from a link.
• Jakym will queue the song once you type it and allow you to add the next song.
• The queue operates independent of the command window and plays the song on a separate thread.
• To exit the command window and hence the application simply type exit.

Commands

• Type spotify to play music using spotify playlist
• Type youtube to play music using youtube playlist
• Use rm to remove the last queued song from the playlist.
• Type shuffle to shuffle your queue.
• Use load to load a playlist and save to save your playlist. Include the trailing slash in path i.e. specify path as C:\Users\Lex\Music\ or /home/lex/Projects/jakym/.
• Use play , pause, next, back to control the playback.
• Use repeat all, repeat song and repeat offto control song repetition.
• Use seek with an integer like 10 or -10 to control the current song.

Installation

To Update jakym simply run pip install --upgrade jakym

Installing ffmpeg

ffmpeg is required for this program to work correctly. Install ffmpeg by following these steps :-

• On Linux - https://www.tecmint.com/install-ffmpeg-in-linux/
• On Windows - https://www.wikihow.com/Install-FFmpeg-on-Windows

Installing simpleaudio

simpleaudio is an optional pydub dependency, however it is essential for proper working of jakym as the playback depends on simpleaudio.

On Linux

• Install Dependencies by sudo apt-get install -y python3-dev libasound2-dev
• Install with: pip install simpleaudio

On Windows

• Download the .whl file of simpleaudio from here
• Once downloaded, it can be installed using the following command : pip install package_name.whl

Installing jakym

• Install by using pypi :-pip install jakym

• Run using jakym command jakym

Violla jakym is now installed!

Enjoy jakym

How It Works

• The program starts and runs two threads, one to input music into the playlist and the other to iterate over the playlist and download the corresponding music and play it.
• The youtube-dl library does most of the heavy lifting of both parsing links and downloading them into a suitable file format.
• The pydub and simpleaudio libraries provide cross-platform audio playback without any issues but setting up simpleaudio on windows and Linux take a different approach.
• The program runs until user specifically types exit.

Version history

Version	Improvements
0.4.0	Playback controls, Bug fixes
0.3.3	Better temporary file management, Playlist management support
0.3.2	Fixed heavy CPU usage while Idling, Added command line arguments, Fixed colour issues on Windows
0.3.1	Bug fixes and Shuffle
0.3	Added Youtube Playlist support, Improved Readme
0.2	Added Spotify playlist support, Bug fixes
0.1.1	Improved documentation, Command line integration
0.1	Initial release

---

Copyright

Copyright (c) 2021 Mayank Jha

License - GNU GPL v3