README.md 2.15 KB
Newer Older
David Planella's avatar
David Planella committed
1 2 3 4 5
# A KDE Jukebox

<img src="https://invent.kde.org/kde/juk/raw/master/128-apps-juk.png" align="right"
     title="Juk logo" width="96" height="96">

Shubham Chaudhary's avatar
Shubham Chaudhary committed
6
[JuK](https://juk.kde.org) is an audio jukebox application, supporting collections of MP3, Ogg Vorbis,
David Planella's avatar
David Planella committed
7
and FLAC audio files. It allows you to edit the tags of your audio files, and
Shubham Chaudhary's avatar
Shubham Chaudhary committed
8
manage your collection and playlists. Its main focus, in fact, is on music
David Planella's avatar
David Planella committed
9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79
management.

Learn more about [Juk at KDE.org](https://www.kde.org/applications/multimedia/juk/).

## Features

<img src="https://juk.kde.org/img/screenshots/juk-3.10.1-tag.png" align="center"
     title="Screenshot of JuK" width="800">

- Collection list and multiple user defined playlists
- Ability to scan directories to automatically import playlists and music files
  on start up
- Dynamic Search Playlists that are automatically updated as fields in the
  collection change.
- A Tree View mode where playlists are automatically generated for sets of
  albums, artists and genres.
- Playlist history to indicate which files have been played and when.
- Inline search for filtering the list of visible items.
- The ability to guess tag information from the file name or using MusicBrainz
  online lookup.
- File renamer that can rename files based on the tag content.
- ID3v1, ID3v2 and Ogg Vorbis tag reading and editing support (via TagLib).

## Installation

The methods listed below for each major OS are based on executing the
installation commands on a terminal window. Alternatively, you can use
your OS' package management app.

Unless using `sudo` to escalate privileges, the installation commands are
expected to be executed as the `root` user.

### Ubuntu

```
sudo apt install juk
```

### Debian

```
apt install juk
```

### CentOS, Fedora, RHEL

```sh
dnf install juk # On CentOs, use 'yum' instead of 'dnf'
```

### OpenSUSE
```
zypper install juk
```

### ArchLinux

1. Enable the `extra` repository on `/etc/pacman.conf`:
    ```
    [extra]
    Include = /etc/pacman.d/mirrorlist
    ```
1. Install the `juk` xz package:
    ```
    # pacman -Sy juk
    ```

### Other OSs

Find your OS and installation instructions on
[Packages Search](https://pkgs.org/download/juk).