README
1Qmmp Plugin Pack
2
3Plugin pack is a set of extra plugins for Qmmp.
4Official home page: https://qmmp.ylsoftware.com/plugins.php
5Development: https://sourceforge.net/projects/qmmp-dev/
6Translation: https://www.transifex.com/qmmp-development-team/
7
8Description:
9- FFap - enhanced Monkey's Audio (APE) decoder (24-bit samples and embedded cue support)
10- XMP - module player with use of the libxmp library
11- Sample Rate Converter - resampler based on libsamplerate library
12- Goom - audio visualization based on goom project
13- FFVideo - video playback engine based on FFmpeg library
14- Ytb - audio playback from YouTube (uses youtube-dl)
15
16Requirements:
17- Qt >= 5.4 (qtbase and qttools for build)
18- qmmp 1.5.x
19- taglib >= 1.11
20- libxmp >= 4.2.0 (optional)
21- libsamplerate >= 0.1.2 (optional)
22- ffmpeg >= 3.4 (optional)
23- youtube-dl (latest version, optional)
24- cmake >= 3.5.0 (for build only)
25
26Attention! Plugin Pack build needs lrelease installed.
27
28Configure:
29cmake ./
30
31Build:
32make
33
34Installation:
35make install
36
37If someone plugin (for example, XMP plugin) doesn't build or doesn't needed you can disable it
38by running the following command:
39cmake ./ -DUSE_XMP:BOOL=FALSE
40
41Available options:
42- USE_FFAP, USE_XMP, USE_SRC, USE_GOOM, USE_FFVIDEO, USE_YTB (plugins)
43
44Also you can use ccmake to change plugin configuration.
45By default program will be installed in /usr/local. You can change default path by running:
46cmake ./ -DCMAKE_INSTALL_PREFIX=custom_path
47
48For more information see GNUInstallDirs module documentation:
49https://cmake.org/cmake/help/latest/module/GNUInstallDirs.html
50
51
52In some cases, you can use qmake for building and installation.
53
54Configure:
55qmake PREFIX=custom_path (default: /usr)
56
57Build:
58make
59
60Installation:
61make install
62
63If someone module doesn't build or doesn't needed you can disable it in qmmp-plugin-pack.pri file - just comment
64corresponding line( symbol '#') or execute qmake with the special parameters:
65qmake DISABLED_PLUGINS+=XMP_PLUGIN DISABLED_PLUGINS+=FFAP_PLUGIN
66
67Attention! By default all plugins are enabled by default.
68
69Changing shared library install path (for some 64-bit distributions).
70By default, all libraries and plugins will be installed to $(INSTALL PREFIX)/lib. You can change "lib"
71to "lib64" by running qmake or cmake with the special parameter:
72qmake LIB_DIR=/usr/lib64
73or
74cmake ./ -DLIB_DIR=lib64
75
76
77To avoid some problems please read below carefully.
78
79How to enable XMP plugin.
80By default ModPlug plugin has higher priority than XMP.
81To fix this go to the "settings"->"plugins" and disable ModPlug plugin.
82
83How to enable FFap plugin.
84Go to the FFmpeg plugin settings and disable Monkey's Audio support.
85
86How to enable FFVideo plugin.
87Go to the "settings"->"plugins" and disable MPlayer plugin.
88
89All patches, bug reports, ideas etc. send to bug tracker https://sourceforge.net/p/qmmp-dev/tickets or
90forkotov02@ya.ru
91
README.RUS
1Qmmp Plugin Pack
2
3Набор дополнительных модулей для Qmmp.
4Официальная домашняя страница: https://qmmp.ylsoftware.com/
5Разработка: https://sourceforge.net/projects/qmmp-dev/
6Перевод: https://www.transifex.com/qmmp-development-team/
7
8Список модулей:
9- FFap - улучшенный декодер Monkey's Audio (APE) (поддержка 24-х бит и встроенного cue)
10- XMP - проигрыватель трекерной музыки с использованием библиотеки libxmp
11- Sample Rate Converter - преобразователь частоты дискретизации с использованием библиотеки libsamplerate
12- Goom - визуализация на базе проекта goom
13- FFVideo - воспроизведение видео с использованием библиотеки FFmpeg
14- Ytb - воспроизведение аудио с YouTube (используется youtube-dl)
15
16Требования:
17- Qt >= 5.4 (qtbase и qttools для сборки)
18- qmmp 1.5.x
19- taglib >= 1.11
20- libxmp >= 4.2.0 (опционально)
21- libsamplerate >= 0.1.2 (опционально)
22- ffmpeg >= 3.4 (опционально)
23- youtube-dl (последняя версия, опционально)
24- cmake >= 3.5.0 (только для сборки)
25
26Внимание! Для сборки набора модулей нужна утилита lrelease.
27
28Конфигурация:
29cmake ./
30
31Сборка:
32make
33
34Установка:
35make install
36
37Если какой-либо модуль (например, XMP) не собирается, или не нужен, то вы можете отключить его командой:
38cmake ./ -DUSE_USE_XMP:BOOL=FALSE
39
40Доступные опции:
41- USE_FFAP, USE_XMP, USE_SRC, USE_GOOM, USE_FFVIDEO, USE_YTB (модули)
42
43Также вы можете использовать ccmake для изменения конфигурации модулей.
44По умолчанию программа будет установлена в /usr/local. Вы можете изменить этот путь командой:
45cmake ./ -DCMAKE_INSTALL_PREFIX=другой_путь
46
47Для получения дополнительной информации смотрите документацию модуля GNUInstallDirs:
48https://cmake.org/cmake/help/latest/module/GNUInstallDirs.html
49
50
51В некоторых случаях вы можете использовать qmake для сборки и установки.
52
53Конфигурация:
54qmake PREFIX=путь_для_установки (по умолчанию: /usr)
55
56Сборка:
57make
58
59Установка:
60make install
61
62Если какой-либо модуль не собирается, или не нужен, то в файле qmmp-plugin-pack.pri можно его отключить.
63Для отключения необходимо закомментировать соответствующую строчку (символ "#").
64Кроме того, отключить модуль можно из командной строки:
65qmake DISABLED_PLUGINS+=XMP_PLUGIN DISABLED_PLUGINS+=FFAP_PLUGIN
66
67Внимание! по умолчанию включены все модули.
68
69Изменение пути установки разделяемых библиотек и модулей (для некоторых 64-битных дистрибутивов).
70По умолчанию все библиотеки и модули будут установлены в $(INSTALL PREFIX)/lib. Вы можете сменить "lib"
71на "lib64" запустив qmake или cmake со специальным параметром:
72qmake LIB_DIR=/usr/lib64
73или
74cmake ./ -DCMAKE_INSTALL_LIBDIR=lib64
75
76
77Для предотвращения некоторых проблем, пожалуйста, прочитайте ниже внимательно.
78
79Как включить модуль XMP.
80По умолчанию модуль ModPlug имеет приоритет выше, чем XMP.
81Для решения этой проблемы перейдите в "настройки"->"модули" и отключите модуль ModPlug.
82
83Как включить модуль FFap.
84Перейдите в настройки модуля FFmpeg и отключите поддержку Monkey's Audio.
85
86Как включить модуль FFVideo.
87Перейдите в "настройки"->"модули" и отключите модуль MPlayer.
88
89Патчи, багрепорты, идеи и т.п.: https://sourceforge.net/p/qmmp-dev/tickets/ или forkotov02@ya.ru
90