Audioboeken handleiding voor uitgevers
Inleiding
Transitieperiode Luisterhuis - CB
De integratie van de audioboeken in de CB systemen zal gefaseerd worden doorgevoerd. Deze handleiding bevat gedurende de transitieperiode dan ook informatie over de processen die nog via Luisterhuis en processen die inmiddels via CB lopen. Gedurende de transitieperiode zal de handleiding aangepast worden op de actuele situatie.
Aanleverspecificaties audioboeken
Masterfiles, metadata, fragmenten en beelden voorbereiden, uploaden en vrijgeven.
Voor wie is deze handleiding?
Deze handleiding is primair bedoeld voor iedereen bij een uitgeverij die zich met het productie- en distributieproces van audioboeken bezighoudt. Bij Luisterhuis noemen wij deze persoon de ‘content contactpersoon’. Ook kan de handleiding belangrijke informatie bevatten voor productiemedewerkers, redactie, marketing, vormgevers en studio’s.
In tegenstelling tot e-books, die klein in omvang zijn en slechts uit één bestand bestaan, gaat het bij de verwerking van digitale audioboeken om een hele verzameling losse - en ook grote - bestanden.
Deze handleiding beschrijft aan welke specificaties al die bestanden van een digitaal audioboek moeten voldoen om het audioboek zo snel mogelijk door Luisterhuis te kunnen laten verwerken en distribueren naar de verschillende afzetkanalen. Ook beschrijft het de stappen die doorlopen moeten worden en geeft het tips voor een foutloze verwerking.
Hoofdstuk 2 en 3 van deze handleiding bevat specifieke (technische) informatie die ook voor opnamestudio’s bedoeld is.
Documentrevisie
Datum | Omschrijving |
|---|---|
30 jun 2026 | Vanwege de nog lopende transitie van Luisterhuis en/of Luisterhuis/CB naar CB / Bookwire zijn in de handleiding de audio-specificaties en overige onderdelen aangepast omdat Bookwire net iets afwijkende specificaties hanteert voor de verwerking van audioboek-bronbestanden. Op meerdere plekken in de handleiding staat nog Luisterhuis en/of Luisterhuis/CB, omdat de transitie nog in volle gang is wordt dit op een later moment aangepast naar CB of CB/Bookwire |
Mar 22, 2024 | Maximum lengte sample (audiofragment) gewijzigd van 8 minuten naar 5 minuten. Platforms ondervinden problemen met de te lange samples waardoor een audioboek niet kan worden opgenomen op het platform |
Jul 19, 2023 | Hoofdstuk MP3 specificaties Toegevoegd: Maximum bestandsgrootte per mp3-bestand: 250 MB |
Mar 31, 2021 | Hoofdstuk 3.4 Varianten Toegevoegd: Voorbeeld van audioboek bestaande uit 2 delen, meerdere hoofdstukken en verschillende paragrafen binnen een hoofdstuk |
Feb 11, 2021 | Hoofdstuk 3 Bestandsnaampatroon MP3 masterfiles Toegevoegd: Met de ingebruikname van een nieuwe release van Luisterhuis ondersteunt Luisterhuis nu ook _ (underscores) in plaats van spaties in de mp3-bestandsnamen. De underscore wordt gezien als het equivalent van een spatie. Een bestandsnaam mag zowel spaties als underscores bevatten. De overige bestandsnaamregels veranderen niet. |
Oct 6, 2020 | Toegevoegd: Onderhouden, registreren en vrijgeven audioboeken Verwijderd Hoofdstukken Waar is metadata zichtbaar in Luisterhuis en Vrijgeven van een audioboek aan afnemers |
Aug 25, 2020 | Hoofdstuk 7 verdere toelichting op doorlooptijd |
May 8, 2020 | Hoofdstuk 5.1.4 Upload mp3 bestanden, foutmeldingen CB online uitgebreid |
Apr 21, 2020 | Hoofdstuk 6 Verwijderd: spoedprocedure, deze is niet meer relevant nu de verwerking via CB Online verloopt |
Apr 15, 2020 | Hoofdstuk 5 Levering aan Luisterhuis verwijderd, niet meer relevant. Toegevoegd Upload mp3 bestanden via CB Online |
Mar 31, 2020 | Hoofdstuk 4 overgang van Luisterhuis naar CB |
Mar 27, 2020 | Hoofdstuk 3 overgang van Luisterhuis naar CB Coverformaat: Optimaal formaat 3000x3000 pixels, minimaal 1400x1400 pixels. Beelden in een lagere resolutie dan 1400x1400 worden afgewezen. |
Technische specificaties audio masterfiles
Chapterized mp3 audio
Luisterhuis verwerkt audiobestanden van uitgevers en stuurt deze door naar de verschillende, door de uitgever geselecteerde, afnemers.
Luisterhuis werkt intern met ‘chapterized’ masterfiles in mp3-formaat. Dat wil zeggen dat één audioboek meerdere mp3-tracks omvat die samen het hele audioboek bevatten.
De individuele mp3-tracks zijn te vergelijken met hoofdstukken uit het ingesproken boek. Gewoonlijk wordt elk hoofdstuk dus een aparte mp3-track. Deze chapterized structuur maakt het mogelijk dat afnemers van Luisterhuis hun audioboeken-app voorzien van een inhoudsopgave en hoofdstuknavigatie. Lang niet elke afnemer biedt deze optie, maar omdat Luisterhuis deze structuur ondersteunt worden de afnemers hierin dus niet beperkt. Afnemers die losse mp3-bestanden leveren aan hun klanten kunnen daardoor dus ook losse bestanden per hoofdstuk leveren, wat minder foutgevoelig is tijdens het downloaden omdat de bestanden per stuk veel kleiner zijn dan één bestand met daarin het gehele audioboek.
Omdat Luisterhuis intern met chapterized audio werkt, moeten de audioboeken ook op deze manier worden aangeleverd. In dit hoofdstuk worden de technische specificaties van de mp3-bestanden beschreven. In hoofdstuk 3 staat alles over de bestandsnaamstructuur die hoort bij ‘Chapterized audio’.
Mp3-specificaties
Luisterhuis gebruikt en vereist het mp3-audioformaat voor de aanlevering van de chapterized masterfiles.
De mp3-bestanden moeten als volgt worden aangeleverd: | |
Enkelvoudige stem: Samplerate 44.1 kHz / 16 bit, bitrate 128 kbps tot 320 kbps CBR, stereo. | |
Hoorspel, muziekproducties: samplerate 44.1 kHz, bitrate 256 kbps CBR, stereo | |
Geluidsniveau: -1dB True Peak (maximaal) | |
Geaccepteerde loudness niveaus: -18 LUFS tot -16 LUFS (ca. -21 dB RMS tot -19 dB RMS) voor het gehele audioboek | |
Maximum tracklengte per mp3-bestand: 60 minuten | |
Sample (luistervoorbeeld, fragment): zelfde audiospecificaties als bovenstaand, minimaal 90 seconden, maximaal 5 minuten. | |
Conform de standaard MP3 bestandsnaamgeving van CB, zie hoofdstuk 3. | |
ID3tags: niet nodig | |
Wav en andere formaten
Bronbestanden in andere formaten dan mp3 worden niet geaccepteerd.
Bestandsnaampatroon MP3 masterfiles
Metadata
Onderhouden, registreren en vrijgeven audioboeken
Uploaden MP3 masterfiles
Updaten MP3 masterfiles
Tips voor een snelle verwerking
Doorlooptijd voor het verwerken van audioboeken
In tegenstelling tot e-books, die klein in omvang zijn en slechts uit één bestand bestaan, gaat het bij de verwerking van digitale audioboeken om een hele verzameling losse - en ook grote - bestanden. Deze verschillende losse bestanden vergroten de kans op fouten, en de grootte van alle audiofiles (een audioboek is al snel 100x zo groot als een e-book) zorgt voor een relatief tragere verwerking. Ook zitten er meer schakels in het verwerkingsproces dan bij e-books. De doorlooptijd na het uploaden van MP3-bestanden bedraagt gemiddeld twee tot drie uur. Zolang de verwerking loopt staat in CB Online achter het kopje Bronbestanden ‘In verwerking’.
Let op: de status blijft op ‘In verwerking’ staan als het audioboek in CB Online geen (automatische) verschijningsdatum heeft, dus bv bij ‘Het boek mag niet verschijnen’.
De verwerking is geautomatiseerd en wordt achteraf aangevuld met handmatige controles. Mocht de audio of metadata incompleet zijn dan heeft dat gevolgen voor de doorlooptijd.
Een titel is pas compleet als per titel deze onderdelen zijn ontvangen:
Een titel is pas compleet als per titel deze onderdelen zijn ontvangen: | |
|---|---|
Mp3-bestanden van het audioboek met correcte bestandsnamen | |
Luistervoorbeeld (mp3) | |
Vierkante cover (jpg, minimaal 1400x1400 pixels, liever groter) | |
Metadata via CB Online of ONIX bevat minimaal auteur, spreker, annotatie, omschrijving, 1x NUR (waarde groter dan of gelijk aan 200), 1x BISAC, 1x Thema en prijs | |
Voorkom vertraging
CB controleert en verwerkt audioboeken in volgorde van binnenkomst. Als de bronbestanden compleet zijn en voorzien van de goede naamgeving, én als bovendien de metadata compleet is en geen technische fouten bevat, dan zijn de audioboeken direct gereed om te verschijnen, ook ’s avonds en in het weekend. Er wordt dan meteen een automatische mail aan de uitgever gestuurd dat titel verwerkt is. Er vindt daarna binnen enkele dagen nog een handmatige controle plaats. Hier wordt gecontroleerd of de audiobestanden, fragment, cover en overige metadata bij elkaar horen. Ook wordt gecontroleerd of de correcte voorlezer is ingevuld en of het eerste en laatste audio bronbestand correct is. Als er fouten worden vastgesteld tijdens deze handmatige controle dan neemt CB contact op met de uitgever.
Dit levert vertraging op:
geen vierkante cover
cover met een te lage resolutie (kleiner dan 1400 x 1400 pixels), foute bestandsnaam ([titel].jpg is fout, [isbn].jpg is goed), ongeldig beeldformaat (png, pdf) of kleurformaat (CMYK)
ontbrekende serie informatie in de metadata (indien serie wel op de cover staat)
ontbrekende of foutieve Thema in de metadata (minstens één Thema verplicht)
ontbrekende of foutieve BISAC in de metadata (minstens één BISAC verplicht)
ontbrekende of foutieve NUR in de metadata (minstens één NUR verplicht)
ontbrekende verkoopprijs in de metadata (RRP)
ontbrekende of foutieve naam van de auteur(s) in de metadata
ontbrekende of foutieve naam van de spreker(s) in de metadata (wordt gecontroleerd met de hoorbare naam in het eerste audiobestand)
titel, ondertitel, serienaam, auteur, sprekers, korte en lange teksten in HOOFDLETTERS in de metadata
ontbrekende of te lange korte tekst in metadata (korte tekst is verplicht en mag niet meer dan 200 tekens omvatten).
namen in verkeerde volgorde (Achternaam, Voornaam is fout; Voornaam Achternaam is correct)
ontbrekend fragment of fragment met foute bestandsnaam ([titel].mp3 is fout, moet [isbn].mp3 of fragment.mp3 zijn)
te kort of te lang fragment (minimum 90 seconden, maximaal 5 minuten)
ontbrekende audiotracks
ontbrekende intro ( de titel, auteur en spreker uit intro worden gebruikt om te contoleren of metadata en namen kloppen)
audiotracks in afwijkend audioformaat (alleen mp3 wordt ondersteund, geen wav, aiff, flac, mp4 etc.)
audiotracks met foute naamgeving (geen titel, geen hoofdstuknaam)
audiotracks met verboden tekens in de bestandsnaam (!/?/&/:/;/diacrieten)
PDF-boekje meeleveren met audioboek
Het is mogelijk een PDF-bestand mee te leveren met een audioboek. Alle webwinkels en sommige audioboek-platforms ondersteunen dit. Op deze manier kan een synopsis, literatuurlijst of bijlage met tabellen, afbeeldingen, foto’s of grafieken met een audioboek worden meegeleverd. Als het audioboek oorspronkelijk op CD was uitgebracht kan dit PDF-bestand ook worden gebruikt om het bijbehorende boekje (het zgn. ‘CD booklet’) mee te leveren. Er is slechts één PDF-bestand mogelijk en andere bestandsformaten dan PDF worden niet ondersteund.
De naamgeving van het PDF-bestand is niet van belang, zolang de extensie maar .pdf is. De bestandsnaam wordt na upload automatisch omgezet naar [ISBN].pdf. Dat betekent dat de gekozen bestandsnaam niet zichtbaar wordt bij de consument.
Werkwijze:
Bij een nieuw audioboek: Upload het PDF-bestand tegelijk met de MP3-bronbestanden.
Updaten van een PDF-boekje: Upload het vernieuwde PDF-bestand tegelijk met de (bestaande) MP3-bronbestanden.
Verwijderen van een PDF-boekje: Upload de (bestaande) MP3-bronbestanden zonder PDF-boekje
MP3 bronbestanden uploaden via SFTP
Het is ook mogelijk om de MP3-bronbestanden (en eventueel het bijbehorende PDF-bestand, zie hierboven) via SFTP te uploaden. Deze optie is met name bedoeld voor uitgevers die ook al geautomatiseerd de ONIX metadata, afbeeldingen en samples aanleveren. Uploaden via SFTP vervangt dan het handmatig uploaden via CB Online.
Dit betreft een andere FTP-server dan de reguliere FTP-servers van CB en vereist andere inloggegevens.
Om van deze mogelijkheid gebruik te maken moet een verzoek worden ingediend bij CB Applicatiebeheer.
Endpoint: sftp.luisterhuis.nl
Poort: 22
Authenticatie: username/password of keyfile
De SFTP-server heeft twee mappen: in en out
De in-map wordt gebruikt voor de aanlevering van de MP3-bronbestanden door de uitgever:
De naamgeving van de bronbestanden moet voldoen aan de standaard zoals hierboven beschreven.
Maak een submap [ISBN] in de in-map van het SFTP-account. Let op dat hier exact 13 cijfers gebruikt worden, zonder extra spaties of interpunctie.
Plaats alle MP3 bronbestanden (en eventueel het bijbehorende PDF-bestand) in deze ISBN-map.
Na 2 tot 3 uur wordt de inhoud van de ISBN-map verwerkt. Na succesvolle verwerking zal de ISBN-map met inhoud verdwijnen.
Bij problemen, zoals bv een incomplete set MP3-bestanden of fouten in een bestandsnaam, blijft de ISBN-map met inhoud staan.
De ISBN-map blijft ook staan als het gebruikte ISBN (nog) niet aangemeld is bij CB. Op zich kunnen MP3-bronbestanden al op de SFTP-server worden neergezet voordat het ISBN bij CB bekend is. De bestanden blijven dan wachten totdat het ISBN is aangemeld bij CB, waarna de verwerking alsnog begint.
De out-map bevat de feedback per verwerkt audioboek:
De out-map bevat bestanden met informatie over de verwerking. Dit zijn bestanden met de extensie .ok, .pen of .err. De bestandstructuur is json.
Een bestand met de naam [isbn]_[timestamp].ok geeft aan dat het betreffende audioboek correct is verwerkt (‘ok’).
Een bestand met de naam [isbn]_[timestamp].pen geeft aan dat het betreffende audioboek nog niet kan worden verwerkt omdat de metadata nog onbekend is bij CB (‘pending’).
Een bestand met de naam [isbn]_[timestamp].err geeft aan dat er een probleem is met één of meer audioboekbestanden (‘error’).
De inhoud van de .ok, .pen en .err-bestanden bevat een json-array met detailinformatie. In .err-bestanden staat onder andere ook het geconstateerde probleem.
De MP3-sample van een audioboek (het luistervoorbeeld), de ONIX-metadata xml en de coverafbeelding jpg moeten allemaal via de reguliere FTP-route aan CB geleverd worden. Als een sample, ONIX of afbeelding toch op de SFTP-server geplaatst worden zorgt dat voor een foutmelding.