Dateiformat & EditorFile format & editor

Das .museum-FormatThe .museum format

Eine Datei pro Werk: Bild, Vorschaubild, optionale Normal Map und strukturierte Metadaten in beliebig vielen Sprachen. Der Editor erstellt sie, das Unreal-Plugin liest sie, und auf Knopfdruck entstehen daraus LIDO-XML und ein IIIF-Manifest für die bestehende Kulturdaten-Infrastruktur. One file per artwork: image, preview, optional normal map and structured metadata in any number of languages. The editor creates it, the Unreal plugin reads it, and at the push of a button it becomes LIDO XML and a IIIF manifest for the existing cultural data infrastructure.

Binärformat v2.0Binary format v2.0 20+ Sprachen20+ languages Wikidata · Wikipedia IIIF- & LIDO-ImportIIIF & LIDO import LIDO- & IIIF-ExportLIDO & IIIF export UE5-PluginUE5 plugin .gallery-Archiv.gallery archive
AufbauStructure

Was steckt in einer .museum-Datei?What’s inside a .museum file?

Kein ZIP-Archiv, sondern ein Binärcontainer mit fester Struktur. Ein 64-Byte-Header mit der Signatur MUSM, Versionsnummer und einer CRC32-Prüfsumme verweist auf einen 64-Byte-Index. Dieser kennt Position und Größe jedes Datenblocks. Not a ZIP archive but a binary container with a fixed structure. A 64-byte header with the MUSM signature, version number and a CRC32 checksum points to a 64-byte index that knows the position and size of every data block.

Das ermöglicht selektives Laden: Eine Anwendung liest zuerst nur die Metadaten, holt bei Bedarf das Vorschaubild und dekodiert das hochaufgelöste Bild erst, wenn es wirklich gebraucht wird. This enables selective loading: an application first reads only the metadata, fetches the preview when needed and decodes the high-resolution image only when it is actually required.

Neue Versionen erweitern das Format abwärtskompatibel. Dateien ohne Normal Map aus früheren Versionen bleiben lesbar. New versions extend the format in a backwards-compatible way. Earlier files without a normal map remain readable.

bei-der-kupplerin.museumlittle-endian
HEADER64 Byte
Signatur MUSM · Version 2.0 · Flags · Offsets · CRC32MUSM signature · version 2.0 · flags · offsets · CRC32
INDEX64 Byte
UUID · Position und Größe jedes Blocks · Bildmaße · BildformatUUID · position and size of each block · image size · image format
METADATENMETADATAvariabelvariable
UTF-8-JSON · Titel, Künstler, Datierung, Maße, Standort, Rechte, Darstellung, ÜbersetzungenUTF-8 JSON · title, artist, date, dimensions, location, rights, display, translations
VORSCHAUBILDPREVIEWJPEG
256 × 256 px · für Listen und Galerieansichten256 × 256 px · for lists and gallery views
BILDIMAGEPNG / JPEG
Originalbild in voller Auflösung · wird erst bei Bedarf geladenFull-resolution original · loaded only when needed
NORMAL MAPoptional · JPEGoptional · JPEG
Oberflächenrelief für Pinselstrich und Leinwand im StreiflichtSurface relief for brushwork and canvas under raking light
Vermeer, Bei der Kupplerin, mit Objekttafel im virtuellen Museum
Johannes VermeerBei der Kupplerin, 1656 · Tafeltext aus der .museum-DateiJohannes VermeerThe Procuress, 1656 · label text from the .museum file
Im Raum sichtbarVisible in the room

Metadaten, die man siehtMetadata you can see

Was im Editor gepflegt wird, erscheint in der Ausstellung: Titel, Entstehungsjahr, Maße, Technik, Beschreibung und besitzende Institution stehen auf der Objekttafel neben dem Werk. What is maintained in the editor appears in the exhibition: title, year, dimensions, medium, description and holding institution are shown on the label next to the work.

Da jedes Feld in mehreren Sprachen vorliegen kann, lesen Besucher die Tafel in ihrer Sprache, ohne dass dafür eine zweite Datei nötig ist. Because every field can exist in several languages, visitors read the label in their own language without needing a second file.

Metadaten-SchemaMetadata schema

Die Felder eines DatensatzesThe fields of a record

Die Metadaten sind UTF-8-JSON. Felder mit dem Zusatz _localized enthalten eine Zuordnung von Sprachcode zu Text.The metadata is UTF-8 JSON. Fields with the _localized suffix map language codes to text.

FeldField TypType InhaltContent
uuidUUIDEindeutige Kennung des WerksUnique identifier of the work
title, title_localizedText, Sprachmaptext, language mapTitel, je SpracheTitle, per language
artistObjektobjectName (lokalisiert), Geburts- und Todesjahr, NationalitätName (localised), years of birth and death, nationality
creationObjektobjectEntstehungsjahr oder Zeitraum, Epoche (lokalisiert)Year or date range, period (localised)
mediumObjektobjectTechnik und Material (lokalisiert)Medium and material (localised)
dimensionsObjektobjectBreite und Höhe in ZentimeternWidth and height in centimetres
physical_locationObjektobjectMuseum (lokalisiert), Stadt, Land, InventarnummerMuseum (localised), city, country, inventory number
description_short, description_localizedText, Sprachmaptext, language mapBeschreibung, je SpracheDescription, per language
tagsListelistSchlagwörter für Suche und GruppierungKeywords for search and grouping
rightsObjektobjectLizenz und BildnachweisLicence and credit line
vr_displayObjektobjectAnzeigebreite und -höhe in Metern, Betrachtungsabstand, Lichttyp, Rahmenstil (frame_style), WandfarbeDisplay width and height in metres, viewing distance, lighting type, frame style (frame_style), wall colour
MehrsprachigkeitLocalisation

20+ Sprachen in einer Datei20+ languages in one file

Titel, Künstlername, Technik, Epoche, Museum und Beschreibung werden je Sprache gespeichert. Eine einzige .museum-Datei trägt beliebig viele Übersetzungen, ohne Zusatzdateien oder Datenbank. Title, artist name, medium, period, museum and description are stored per language. A single .museum file carries any number of translations, without extra files or a database.

Beim Import aus Wikidata und Wikipedia übernimmt der Editor vorhandene Übersetzungen automatisch. Über die Sprachleiste wechseln Sie zwischen den Fassungen und ergänzen fehlende Texte. When importing from Wikidata and Wikipedia, the editor takes over existing translations automatically. The language bar switches between versions so you can fill in missing texts.

DEENFRESITPTNLRUPLUKZHJAKOARTRSVCSFIHURO+
bei-der-kupplerin.museum · metadata 
{
  "title": "Bei der Kupplerin",
  "title_localized": {
    "de": "Bei der Kupplerin",
    "en": "The Procuress",
    "fr": "L’Entremetteuse",
    "nl": "De koppelaarster"
  },
  "artist": {
    "name": "Johannes Vermeer",
    "birth_year": 1632,
    "death_year": 1675
  },
  "dimensions": { "width_cm": 130, "height_cm": 143 },
  "vr_display": {
    "suggested_width_m": 1.3,
    "frame_style": "ornate_gold",
    "wall_color_suggestion": "#2a1f14"
  }
}
Editor

Werke erfassen, ohne IT-KenntnisseCataloguing without IT skills

Der Editor läuft im Browser, ohne Installation und ohne Server. Als Desktop-App für Windows kommen Dateizuordnung, native Menüs, ein Arbeitsverzeichnis und Cloud-Speicher (S3-kompatibel, z. B. MinIO) hinzu. The editor runs in the browser, with no installation and no server. As a Windows desktop app it adds file associations, native menus, a working folder and cloud storage (S3-compatible, e.g. MinIO).

Import: Wikipedia-Link, Wikidata-Suche oder QID, die URL eines IIIF-Manifests oder eine LIDO-XML-Datei. Titel, Künstler, Datierung, Technik, Maße, Standort und Beschreibung werden übernommen. Import: a Wikipedia link, a Wikidata search or QID, the URL of a IIIF manifest or a LIDO XML file. Title, artist, date, medium, dimensions, location and description are taken over.

Bildprüfung: Nach dem Laden zeigt der Editor, ob Auflösung und Seitenverhältnis für Unreal Engine passen, wie viel Grafikspeicher die Textur belegt, wie scharf das Bild ist und ob Ränder oder JPEG-Artefakte stören. Aus den Bildfarben schlägt er eine Wandfarbe vor und erzeugt auf Wunsch eine Normal Map. Image check: after loading, the editor shows whether resolution and aspect ratio suit Unreal Engine, how much video memory the texture will use, how sharp the image is and whether borders or JPEG artefacts get in the way. It suggests a wall colour from the image and generates a normal map on request.

Export: die .museum-Datei sowie LIDO-XML und ein IIIF-Manifest. Entwürfe werden automatisch zwischengespeichert. Export: the .museum file plus LIDO XML and a IIIF manifest. Drafts are saved automatically.

Zugang zum Editor anfragenRequest editor access
Sammlungen & .galleryCollections & .gallery

Ganze Sammlungen verwaltenManage entire collections

Die Galerieansicht liest viele .museum-Dateien auf einmal und dekodiert dafür nur die Vorschaubilder. Eine Suche filtert nach Titel, Künstler oder Beschreibung. The gallery view reads many .museum files at once and decodes only their previews. A search filters by title, artist or description.

Die geladene Sammlung lässt sich als .gallery-Datei exportieren: ein ZIP-Archiv mit allen Werken, das sich auf einem anderen Rechner wieder öffnen lässt. Das Unreal-Plugin liest .gallery-Archive direkt, das gewünschte Werk wählt man im Details-Panel aus. The loaded collection can be exported as a .gallery file: a ZIP archive with all works that opens again on any other machine. The Unreal plugin reads .gallery archives directly; you pick the artwork in the details panel.

InteroperabilitätInteroperability

Anschluss an die bestehende InfrastrukturConnected to existing infrastructure

Das Format konkurriert nicht mit etablierten Kulturdaten-Standards, es liefert sie als Ergebnis. Was im Editor kuratiert wurde, geht ohne zweite Erfassung in Portale und Viewer.The format doesn’t compete with established cultural data standards, it produces them. What was curated in the editor flows into portals and viewers without being entered twice.

LIDO-XML

Für Kulturportale und AggregatorenFor cultural portals and aggregators

Erzeugt LIDO-XML mit Titeln und Beschreibungen in allen gepflegten Sprachen, Herstellungsereignis mit Künstler und Datierung, Maßangaben, Standort und Inventarnummer. LIDO ist das gängige Lieferformat für die Deutsche Digitale Bibliothek und über sie für Europeana.Generates LIDO XML with titles and descriptions in every maintained language, a production event with artist and date, measurements, location and inventory number. LIDO is the common delivery format for the German Digital Library and, through it, for Europeana.

Deutsche Digitale BibliothekGerman Digital Library Europeana museum-digital
IIIF-ManifestIIIF manifest

Für Viewer und BildserverFor viewers and image servers

Erzeugt ein Manifest nach der IIIF Presentation API 3.0. Damit lässt sich ein Werk in Mirador, Universal Viewer und anderen IIIF-fähigen Viewern einbinden, ohne bestehende Abläufe der Institution zu ändern.Generates a manifest following the IIIF Presentation API 3.0, so a work can be embedded in Mirador, Universal Viewer and other IIIF-capable viewers without changing the institution’s existing processes.

Presentation API 3.0 Mirador Universal Viewer

Auch in die andere Richtung: IIIF-Manifeste anderer Institutionen und vorhandene LIDO-Exporte aus Ihrem Sammlungsmanagement lassen sich in den Editor importieren. Metadaten müssen nicht neu erfasst werden.The other way round, too: IIIF manifests from other institutions and existing LIDO exports from your collection management system can be imported into the editor. Metadata doesn’t have to be entered again.

Unreal-Engine-5-PluginUnreal Engine 5 plugin

Direkt in Blueprints nutzbarReady to use in Blueprints

Das Plugin Museum Loader liest .museum-Dateien und .gallery-Archive zur Laufzeit. Einzelne Blueprint-Knoten decken jeden Schritt ab: Ordner durchsuchen, nur Metadaten lesen, Vorschaubild laden, Vollbild laden, synchron oder asynchron. The Museum Loader plugin reads .museum files and .gallery archives at runtime. Individual Blueprint nodes cover each step: scan a folder, read metadata only, load the preview, load the full image, synchronously or asynchronously.

Get Localized Text liefert einen Text in der gewünschten Sprache und fällt sonst auf eine zweite Sprache, dann auf Englisch und zuletzt auf den ersten vorhandenen Eintrag zurück. Get Localized Text returns text in the requested language and otherwise falls back to a second language, then English, then the first available entry.

Die Museum Painting Component lädt eine Datei beim Spielstart oder schon im Editor. Abgeleitete Blueprints setzen nur den Dateipfad und erhalten Bild, Normal Map und Metadaten. Die Museum Gallery Component macht dasselbe für ein .gallery-Archiv. The Museum Painting Component loads a file at begin play or already in the editor. Child Blueprints only set the file path and receive image, normal map and metadata. The Museum Gallery Component does the same for a .gallery archive.

Load Museum Metadata Load Museum Artwork Async Load Gallery Archive Get Localized Text
MuseumLoader · C++ / Blueprint API 
// Read metadata only, no image decoding
FMuseumArtworkInfo Info;
UMuseumLoaderBPLib::LoadMuseumMetadata(Path, Info);

// Title in the visitor's language, with fallback
FString Title = UMuseumLoaderBPLib::GetLocalizedText(
    Info.TitleLocalized, TEXT("de"), TEXT("en"));

// Preview right away, full image when needed
UTexture2D* Thumb =
    UMuseumLoaderBPLib::LoadMuseumThumbnail(Path);
UTexture2D* Full =
    UMuseumLoaderBPLib::LoadMuseumFullImage(Path);
EinordnungPositioning

Was .museum leistet und was nichtWhat .museum does, and what it doesn’t

.museum ergänzt das Sammlungsmanagement, es ersetzt es nicht. Der Vergleich zeigt die bewusste Abgrenzung..museum complements collection management, it doesn’t replace it. The comparison shows the deliberate boundaries.

FähigkeitCapability .museum IIIF-ViewerIIIF viewer Sammlungs­managementCollection management TIFF + DateiablageTIFF + file share
Erfassung im Browser, ohne IT-KenntnisseCapture in the browser, no IT skills needed✓–○–
Import aus Wikidata und Wikipedia, mehrsprachigMultilingual import from Wikidata and Wikipedia✓–○–
IIIF-Manifeste anderer Institutionen übernehmenTake over IIIF manifests from other institutions✓✓––
Bildprüfung für Echtzeit-3D (Auflösung, Grafikspeicher, Schärfe)Image check for real-time 3D (resolution, video memory, sharpness)✓–––
Darstellungsangaben eingebettet (Rahmen, Größe, Wandfarbe)Display settings embedded (frame, size, wall colour)✓–––
Direkt in Unreal Engine 5 ladbarLoads directly into Unreal Engine 5✓–––
LIDO-XML exportierenLIDO XML export✓–○–
IIIF-Manifest erzeugenIIIF manifest generation✓–○–
Wissenschaftliche Tiefendokumentation (Provenienz, Änderungsprotokoll)In-depth scholarly documentation (provenance, audit trail)––✓–
Kontrollierte Vokabulare (z. B. Getty AAT, ULAN, GND)Controlled vocabularies (e.g. Getty AAT, ULAN, GND)––✓–

✓ vorhanden · ○ eingeschränkt oder je nach Produkt · – nicht vorgesehen. Sammlungsmanagement meint Systeme wie MuseumPlus, Axiell EMu oder TMS.✓ available · ○ limited or product-dependent · – not intended. Collection management refers to systems such as MuseumPlus, Axiell EMu or TMS.

WeiterentwicklungRoadmap

Das Format wächst mitThe format keeps growing

Jede neue Version erweitert den Container abwärtskompatibel. Bestehende Dateien bleiben lesbar.Every new version extends the container in a backwards-compatible way. Existing files stay readable.

v2.0

AktuellCurrent
  • Binärcontainer mit CRC32-Prüfsumme und selektivem LadenBinary container with CRC32 checksum and selective loading
  • Optionale Normal MapOptional normal map
  • Metadaten in 20+ Sprachen samt DarstellungsangabenMetadata in 20+ languages plus display settings
  • Import aus Wikidata, Wikipedia, IIIF und LIDOImport from Wikidata, Wikipedia, IIIF and LIDO
  • Export als LIDO-XML und IIIF-ManifestExport as LIDO XML and IIIF manifest
  • .gallery-Archiv für Sammlungen.gallery archive for collections

v3.0

GeplantPlanned
  • 3D-Objekte (glTF) als zusätzlicher Datenblock3D objects (glTF) as an additional data block
  • Eingebettete Audiospuren für GuidesEmbedded audio tracks for guides
  • Video und AnimationVideo and animation
  • Für Streaming optimierter ExportStreaming-optimised export
  • Kryptografische Signaturen zur HerkunftsprüfungCryptographic signatures to verify origin

LangfristigLong term

VisionVision
  • Öffentliche FormatspezifikationPublic format specification
  • Validierungsbibliothek als Open SourceOpen-source validation library
  • Plugins für weitere Engines (Unity, Godot)Plugins for further engines (Unity, Godot)
  • Einbringen in StandardisierungsgremienContribution to standards bodies

Lizenznehmer erhalten neue Formatversionen und die vollständige Spezifikation. Mit dem LIDO- und IIIF-Export bleiben Ihre Daten zusätzlich unabhängig von NextMuseum nutzbar.Licence holders receive new format versions and the full specification. Thanks to LIDO and IIIF export, your data also remains usable independently of NextMuseum.

Nächster SchrittNext step

Ihre Sammlung im .museum-FormatYour collection in .museum format

Wir zeigen Ihnen den Editor an Ihren eigenen Werken und besprechen, welches Lizenzmodell passt.We’ll show you the editor using your own works and discuss which licensing model fits.

Demo vereinbarenArrange a demo Zum PilotprojektPilot programme