multimedia/juk/README.md

0001 # A KDE Jukebox
0002
0003 <img src="https://apps.kde.org/app-icons/org.kde.juk.svg" align="right"
0004      title="Juk logo" width="96" height="96">
0005
0006 [JuK](https://juk.kde.org) is an audio jukebox application, supporting collections of MP3, Ogg Vorbis,
0007 and FLAC audio files. It allows you to edit the tags of your audio files, and
0008 manage your collection and playlists. Its main focus, in fact, is on music
0009 management.
0010
0011 Learn more about [Juk at KDE.org](https://www.kde.org/applications/multimedia/juk/).
0012
0013 ## Features
0014
0015 <img src="https://cdn.kde.org/screenshots/juk/juk.png" align="center"
0016      title="Screenshot of JuK" width="800">
0017
0018 - Collection list and multiple user defined playlists
0019 - Ability to scan directories to automatically import playlists and music files
0020   on start up
0021 - Dynamic Search Playlists that are automatically updated as fields in the
0022   collection change.
0023 - A Tree View mode where playlists are automatically generated for sets of
0024   albums, artists and genres.
0025 - Playlist history to indicate which files have been played and when.
0026 - Inline search for filtering the list of visible items.
0027 - The ability to guess tag information from the file name
0028   - Previous versions could also use MusicBrainz online lookup, but we need help to
0029     get that working again.
0030 - File renamer that can rename files based on the tag content.
0031 - ID3v1, ID3v2 and Ogg Vorbis tag reading and editing support (via TagLib).
0032
0033 ## Installation
0034
0035 The methods listed below for each major OS are based on executing the
0036 installation commands on a terminal window. Alternatively, you can use
0037 your OS' package management app.
0038
0039 Unless using `sudo` to escalate privileges, the installation commands are
0040 expected to be executed as the `root` user.
0041
0042 ### Ubuntu
0043
0044 ```
0045 sudo apt install juk
0046 ```
0047
0048 ### Debian
0049
0050 ```
0051 apt install juk
0052 ```
0053
0054 ### CentOS, Fedora, RHEL
0055
0056 ```sh
0057 dnf install juk # On CentOs, use 'yum' instead of 'dnf'
0058 ```
0059
0060 ### OpenSUSE
0061 ```
0062 zypper install juk
0063 ```
0064
0065 ### ArchLinux
0066
0067 1. Enable the `extra` repository on `/etc/pacman.conf`:
0068     ```
0069     [extra]
0070     Include = /etc/pacman.d/mirrorlist
0071     ```
0072 1. Install the `juk` xz package:
0073     ```
0074     # pacman -Sy juk
0075     ```
0076
0077 ### Other OSs
0078
0079 Find your OS and installation instructions on
0080 [Packages Search](https://pkgs.org/download/juk).