-
Notifications
You must be signed in to change notification settings - Fork 2
/
Copy pathREADME
130 lines (109 loc) · 6.87 KB
/
README
1
2
3
4
5
6
7
8
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
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
This is Audacious (https://audacious-media-player.org/) input plugin for UADE (https://zakalwe.fi/uade/) and other retro music replays.
* IMPORTANT!
- Make sure "Probe content of files with no recognized file name extension" setting is *enabled* and "Guess missing metadata from filepath" setting is *disabled* in Audacious prefs in order for subsongs and meta data to work properly. The playlist must also have been created *after* the settings are applied.
Main features:
- Precalculated database for song lengths and author/album/publisher/year meta data (see below)
- Player independent songend detection (similar to "deep songend scan" option in DeliPlayer for Windows)
- Preferences UI for configuring UADE playback options etc.
- Custom fork of UADE (https://gitlab.com/mvtiaine/uade) including support for additional formats and platforms not (yet) supported in official UADE releases:
-- Face The Music
-- OctaMED Soundstudio / MMD3
-- Protracker4 / Protracker IFF
-- Support for AmigaOS (and related), Windows (MSYS2/MinGW), ...
- MED4 sng+samples format support via MED4->MMD0 conversion
- DigiBooster 3 and DigiBooster Pro 2 (http://www.digibooster.de/) support using the official portable replay
- HivelyTracker (http://www.hivelytracker.co.uk/) support using the official portable replay
- Fasttracker 1 & 2 support using the ft2play replay (https://github.com/8bitbubsy/ft2play)
- Scream Tracker 2 support using the st23play replay by 8bitbubsy (https://pastebin.com/ifXSCZ71)
- Scream Tracker 3 support using the st3play replay by 8bitbubsy (https://pastebin.com/AwRXZAw7)
- Impulse Tracker 1 & 2 support using the it2play replay (https://github.com/8bitbubsy/it2play)
Modland (http://ftp.modland.com/), AMP (https://amp.dascene.net/), UnExotica (https://www.exotica.org.uk/wiki/UnExoticA) and Demozoo (https://demozoo.org/) are used as sources for precalculated song lengths and author/album/publisher/year meta data (if available).
In addition Mods Anthology (https://archive.org/details/cdrom-amiga-mods-anthology-1), Wanted Team (http://wt.exotica.org.uk/), Zakalwe (git://zakalwe.fi/chip) and Aminet (https://aminet.net/) are used as sources for precalculated song lengths.
Project is hosted at https://github.com/mvtiaine/audacious-uade
Companion repo for songdb is at https://github.com/mvtiaine/audacious-uade-tools
* Other notes:
- Case sensitive filesystems may cause issues for formats with external samples
- Tested on 64-bit, 32-bit, big & little endian hosts. Tested on macOS, Linux, DragonFly*/Free*/Net*/OpenBSD, Haiku, Windows (MinGW*/MSYS2, Cygwin), OpenIndiana, GNU Hurd. Libraries/CLI binaries also tested on AmigaOS3, MorphOS, AROS, QNX 6.5.0, AIX, cosmocc, Tizen, Meego/Sailfish, OS/2 (ArcaOS)
- Build support (binaries not tested) for Android, iOS, Fuchsia, OpenHarmony, webOS, RISC OS, FreeMiNT, WarpOS, Redox OS, SerenityOS, Genode, BlackBerry 10, QNX 7, QNX 8, PS4 (OpenOrbis)
- WIP support (runtime failures) for IRIX, AmigaOS4, Wasix, Emscripten, UnixWare.
- Recommended custom Audacious playlist entry/window title template:
${?codec:[${codec}${?channels: (${channels}ch)}]} - ${?artist:${artist} - }${title}${?album: - (${album})} ${?copyright:- (${copyright})}${?publisher:- (${publisher}) }${?year:- (${year}) }${?subsong-id:${?subsong-num:- [${subsong-id}/${subsong-num}]}}
* Some future plans (in no particular order)
- Automatic A500/A1200/None filter selection depending on format/year/platform (OCS/AGA/DOS) etc. meta data
- Plugin support for GStreamer, Hollywood, ...
- Support more platforms
- Add more replays
- PTK-Prowiz converter support (portable C-version)
- Improve UADE format support and portability
- Improve songdb with more coverage and metadata sources
- Project might need a new name...
* License (source code)
The project as a whole is licensed under GPL-2.0-or-later.
Some parts are also licensed under LGPL-2.0-or-later, specifically sources under src/common, src/converter, src/player and src/songdb.
See src/3rdparty for 3rd party source code licenses.
See https://zakalwe.fi/uade/ for UADE license information.
* Dependencies:
Audacious >= 3.8
* To build and install from source (git or latest release):
- required (git or release): pkg-config, GNU make, GCC/Clang with C++17 support (GCC-6+, Clang-5.0+)
- required (git): autoconf, automake, libtool
- (git): make sure uade submodule has been initialized (git submodule update --init --recursive)
(libtoolize)
(autoreconf -i)
mkdir -p build
cd build
../configure
gmake -j
gmake -j check
(sudo) gmake install
* To install via Homebrew (latest release):
brew install mvtiaine/repo/audacious-uade
+ macOS:
ln -s "${HOMEBREW_PREFIX}/lib/audacious/Input/uade.dylib" "$(pkgconf --variable=plugin_dir audacious)/Input/uade.dylib"
+ Linux:
ln -s "${HOMEBREW_PREFIX}/lib/audacious/Input/uade.so" "$(pkgconf --variable=plugin_dir audacious)/Input/uade.so"
* To install from Gentoo overlay (latest release):
# Add https://github.com/mvtiaine/gentoo-overlay.git via layman or eselect repository
emerge -p media-plugins/audacious-uade
emerge media-plugins/audacious-uade
* To install with PKGBUILD for Arch/Manjaro/etc. (latest release):
wget https://raw.githubusercontent.com/mvtiaine/arch-repo/main/audacious-uade/PKGBUILD
makepkg -s
(sudo) pacman -U audacious-uade*.pkg*
* To install with FreeBSD/MidnightBSD ports or DragonFlyBSD DPorts (latest release):
git clone https://github.com/mvtiaine/freebsd-ports.git
cd freebsd-ports/multimedia/audacious-uade
make install clean
* To install with HaikuPorter (latest release):
(pkgman install audacious audacious_plugins)
git clone https://github.com/mvtiaine/haikuports.git
cp -rp haikuports/* /boot/home/haikuports/
haikuporter audacious_uade
pkgman install /boot/home/haikuports/packages/audacious_uade-*
* To install with Alpine aports (latest release):
wget https://raw.githubusercontent.com/mvtiaine/aports/main/audacious-uade/APKBUILD
abuild -r
(sudo) apk add "${HOME}/packages/*/*/audacious-uade*.apk"
* To install with MacPorts (latest release):
git clone https://github.com/mvtiaine/macports.git <path>
# Add file://<path> to ${prefix}/etc/macports/sources.conf
# see https://guide.macports.org/#development.local-repositories
(sudo) port sync
(sudo) port install audacious-uade
* To install with pkgsrc (latest release):
git clone https://github.com/mvtiaine/pkgsrc.git
# change /usr/pkgsrc to correct pkgsrc location as needed
cp -rp pkgsrc/* /usr/pkgsrc/
cd /usr/pkgsrc/audio/audacious-uade
make install clean clean-depends
* To install with OpenBSD ports (latest release):
git clone https://github.com/mvtiaine/openbsd-ports.git
cp -rp openbsd-ports/* /usr/ports/
cd /usr/ports/audio/audacious-uade
make install clean
* To build and install with Debian/Ubuntu/etc. from sources (git or latest release):
scripts/make_deb.sh
(sudo) dpkg -i build-deb/audacious-uade*.deb
* To build and install with Fedora/openSUSE/etc. from sources (git or latest release):
scripts/make_rpm.sh
(sudo) dnf/yum/zypper install build-rpm/rpmbuild/RPMS/*/*.rpm