] BETA How-to start
Download the package (the package contains compiled versions of the application for Windows as well as Mac OS (for Mac OS, both 32-bit and 64-bit versions are included in the package) platforms ... unzip it and start the executable from the command line (on Windows, search for Linux is no longer supported)
CMD) / terminal.
By default the application binds itself (listens) using port 8080, but you can change this by starting the application from the command line using an argument like
(in case you want to run it on port 9000 instead - of course, you can use any port in the range of 1-65536 that happens to be available on your machine). metadata --port=9000 Note that on Traktor you don't need to set up anything other than the address and port for this to work... after all, it's not like this is IceCast or something. :-)
N.B.: If You're using one of the recent versions of Mac OS like Mojave (10.14.x), Catalina (10.15.x), Big Sur (11.x.x) or anything later than the ones mentioned, the operating system might prompt You that it doesn't allow You to start this application since it has not been signed.
I personally think that it
is great that Apple protects the users this way, but - since becoming an "Identified Developer" costs money on a yearly subscription … this isn't truly a viable option for freeware project developers such as myself … sorry for all the Apple users out there for this unnecessary step :( … Also, this is the reason I so far haven't built a native M1/ARM64 -version of the application - since all native M1/ARM64 -code must be signed, no matter what.
However … If this happens, You need to enable access for the application through "
System Preferences /
Security & Privacy /
General" by clicking the "Allow Anyway"-button next to the explanation text
"metadata-osx??" was blocked from use because it is not from an identified developer.
Anyways, once we've gotten the software started…
When the application starts (and successfully binds to a port), it will open Your default browser with address like
http://127.0.0.1:<PORT>/ … this is the default visualizer Web UI, which can be used to initially verify that the application is working properly.
On Your browser, You should see a page with the Harvester logo on the top and "a kinda turntable-platter looking thing" at the bottom.
If this is the case, continue with checking that the application is working … however,
if this isn't the case, something is wrong.
If You see the Harvester-logo, but not the platter … try reloading the page (might need to do that a few times) … sometimes the API doesn't load in time and that's the reason why things don't work properly all the time. This is a known issue that will be fixed later.
If You don't see the Harvester-logo (or anything else), something is "very wrong" and I suggest starting from the beginning … if the server is running on the terminal, You can use
CTRL+C to stop it. The log printed on the terminal might give some hints about what is the problem.
In Traktor (this has been tested with various versions of T2 & T3 - however, this should work just the same even with the "ancient" T1-versions) … You need to set the "Broadcasting" -settings according to the provided picture.
Unlike with the v0.4, You
should not set anything in the "Server Settings / Password" -field; with v0.5, that is no longer used for anything.
Since we are only interested in the metadata of the stream, you can set the "Server Settings / Format" as low as possible. Currently Traktor's lowest setting is "Ogg Vorbis, 11025 Hz, 32 kBit/s".
After You've modified the settings (and the server is still running in the Terminal) … in Traktor, You should start "Broadcasting"; in Your "Global Section" of the main UI, You normally have the FX controls on both sides of the "Master"-controls (Snap/Quant/EXT, Auto/Master, Limiter, etc. in the middle) i.e.; FX1 on the left and FX2 on the right. Instead of FX2 on the right, there You need to switch to the "Audio Recorder"-pane by pressing the button below the "FX" that looks not entirely unlike a "cassette deck"-symbol.
In the "Audio Recorder"-pane, there are two buttons to the left of the rotary dial; the bottom is used to start internal recording and the top one is to start broadcasting.
Pressing the top one, it should light solid cyan. If it starts blinking instead, either Your configuration in "Preferences / Broadcasting / Server Settings" is incorrect
or the application is not working properly. Traktor is broadcasting with solid cyan … what now?
Now You should play something … open the channel in such position that the audio is coming through. When the song has been playing about 10 seconds (this is the time at when Traktor considers the song is "on air") … You should see the Web UI spring to life and display the playing song's artist & song name in Your browser.
N.B.: Traktor only ever sends the artist/song -metadata once after the track has been loaded and that track is initially considered to be "on air". If You return to Your previous track, its metadata will not be sent again … nor will the next track's metadata be sent again when you finally decide to mix it in (if it has already been sent). Alright, I see the track information in the Web UI … What next?
Well … Now You're ready to take the next big step - and this is going to be a leap
You see … the Metadata Harvester is
not supposed to do much by itself - it only "harvests" the metadata from the stream and provides an API for You to peruse.
There are various code examples at
Github that literally show some simple examples of using the API (including the code for the default Web UI) … but … now it's all up to You to make the best use of that API and create something beautiful ;)