{"result":{"depiction_url":null,"edges":{"observes":{"objects":[{"created":"2026-09-09T13:47:40Z","object_id":{"id":1463,"is_a":["text","documentation","reference","notification"],"name":"doc_notification_media_upload_props","title":"observe_media_upload_props\/3","uri":"https:\/\/zotonic.com\/id\/1463"},"seq":1},{"created":"2026-09-09T13:47:40Z","object_id":{"id":1733,"is_a":["text","documentation","reference","notification"],"name":"doc_notification_media_viewer","title":"observe_media_viewer\/2","uri":"https:\/\/zotonic.com\/id\/1733"},"seq":2},{"created":"2026-09-09T13:47:40Z","object_id":{"id":1913,"is_a":["text","documentation","reference","notification"],"name":"doc_notification_media_upload_rsc_props","title":"observe_media_upload_rsc_props\/3","uri":"https:\/\/zotonic.com\/id\/1913"},"seq":3}],"predicate":{"id":2550,"is_a":["meta","predicate"],"name":"observes","title":{"_type":"trans","tr":{"en":"Observes"}},"uri":"https:\/\/zotonic.com\/id\/observes"}},"relation":{"objects":[{"created":"2020-08-19T14:24:52Z","object_id":{"id":1902,"is_a":["text","documentation","reference","module"],"name":"doc_module_mod_video","title":"mod_video","uri":"https:\/\/zotonic.com\/id\/1902"},"seq":1000000},{"created":"2020-08-19T14:24:52Z","object_id":{"id":1901,"is_a":["text","documentation","reference","module"],"name":"doc_module_mod_video_embed","title":"mod_video_embed","uri":"https:\/\/zotonic.com\/id\/1901"},"seq":1000000},{"created":"2020-08-19T14:24:52Z","object_id":{"id":1374,"is_a":["text","documentation","reference","template_tag"],"name":"doc_template_tag_tag_media","title":"media","uri":"https:\/\/zotonic.com\/id\/1374"},"seq":1000000}],"predicate":{"id":303,"is_a":["meta","predicate"],"name":"relation","title":{"_type":"trans","tr":{"nl":"Relatie","en":"Relation"}},"uri":"http:\/\/purl.org\/dc\/terms\/relation"}},"subject":{"objects":[{"created":"2026-09-09T13:47:40Z","object_id":{"id":2555,"is_a":["categorization","keyword","keyword_information_type"],"name":"zotonic_topic_reference","title":"Reference","uri":"https:\/\/zotonic.com\/id\/2555"},"seq":1},{"created":"2026-09-09T13:47:40Z","object_id":{"id":2561,"is_a":["categorization","keyword","keyword_audience"],"name":"zotonic_topic_content_editor","title":"Content editor","uri":"https:\/\/zotonic.com\/id\/2561"},"seq":2},{"created":"2026-09-09T13:47:40Z","object_id":{"id":2576,"is_a":["categorization","keyword","keyword_domain"],"name":"zotonic_topic_media_management","title":"Media management","uri":"https:\/\/zotonic.com\/id\/2576"},"seq":3},{"created":"2026-09-09T13:47:40Z","object_id":{"id":2578,"is_a":["categorization","keyword","keyword_domain"],"name":"zotonic_topic_audio_management","title":"Audio management","uri":"https:\/\/zotonic.com\/id\/2578"},"seq":4},{"created":"2026-09-09T13:47:40Z","object_id":{"id":2580,"is_a":["categorization","keyword","keyword_domain"],"name":"zotonic_topic_file_uploads","title":"File uploads","uri":"https:\/\/zotonic.com\/id\/2580"},"seq":5},{"created":"2026-09-09T13:47:40Z","object_id":{"id":2619,"is_a":["categorization","keyword","keyword_architecture"],"name":"zotonic_topic_media_resource","title":"Media resource","uri":"https:\/\/zotonic.com\/id\/2619"},"seq":6},{"created":"2026-09-09T13:47:40Z","object_id":{"id":2635,"is_a":["categorization","keyword","keyword_architecture"],"name":"zotonic_topic_module","title":"Module","uri":"https:\/\/zotonic.com\/id\/2635"},"seq":7}],"predicate":{"id":308,"is_a":["meta","predicate"],"name":"subject","title":{"_type":"trans","tr":{"en":"Keyword"}},"uri":"http:\/\/purl.org\/dc\/elements\/1.1\/subject"}}},"id":2188,"is_a":["text","documentation","reference","module"],"links":[{"rel":"self","target":"https:\/\/zotonic.com\/.zotonic\/websub\/topic\/2188"},{"rel":"hub","target":"https:\/\/zotonic.com\/.zotonic\/websub"}],"medium":null,"medium_url":null,"name":"doc_module_mod_audio","page_url":{"en":"https:\/\/zotonic.com\/docs\/2188\/mod_audio","x-default":"https:\/\/zotonic.com\/docs\/2188\/mod_audio"},"preview_url":null,"resource":{"version":3796,"pivot_location_lat":null,"title":"mod_audio","is_authoritative":true,"body":"

Adds support for viewing and handling audio medium items.<\/p>\n

This module parses audio files and extracts tags and an optional image from the audio file.<\/p>\n

Note<\/p>

mod_audio uses the command-line utilities ffmpeg<\/code> and ffprobe<\/code>. For mod_audio to function correctly they must be\npresent in the search path of Zotonic.<\/p><\/div>\n

Uploading<\/h2>\n

The audio module hooks into the media model to intercept any audio file upload.<\/p>\n

If an audio file is uploaded then the file is parsed using ffprobe<\/code> to fetch:<\/p>\n

  • The bitrate<\/li>
  • Audio duration<\/li>
  • Tags, like artist, album<\/li>
  • Album art image, extracted as png using ffmpeg<\/code><\/li><\/ul>\n

    The optional album art is used as the preview image. This image is visible when the audio media item is rendered using a\n{% image ... %}<\/code> tag.<\/p>\n

    Viewing<\/h2>\n

    The audio module extends the {% media %}<\/code> tag for viewing audio\/*<\/code> videos.<\/p>\n

    It uses the template _audio_viewer.tpl<\/code> for viewing.<\/p>\n

    Editing<\/h2>\n

    The following properties are extracted from the audio file, and can be edited in the admin:<\/p>\n

    • artist<\/li>
    • album<\/li>
    • album_artist<\/li>
    • composer<\/li>
    • genre<\/li>
    • track<\/li>
    • copyright<\/li>
    • is_compilation (boolean flag)<\/li>
    • org_pubdate, this is extracted form the creation_time<\/code> tag<\/li><\/ul>\n

      If there is no resource title given when creating the audio page then the title from the tags is used. If that one is\nempty then the file’s basename is used.<\/p>\n

      Accepted Events<\/h2>\n

      This module handles the following notifier callbacks:<\/p>\n

      • observe_media_upload_props<\/code>: Set medium properties from the uploaded file using z_media_archive:abspath<\/code>.<\/li>
      • observe_media_upload_rsc_props<\/code>: Set resource properties from the medium properties using z_datetime:to_datetime<\/code>.<\/li>
      • observe_media_viewer<\/code>: Return the media viewer for the audio using z_template:render<\/code>.<\/li><\/ul>","slug":"mod_audio","doc_module_config":[],"is_protected":false,"visible_for":0,"tz":"UTC","language":["en"],"doc_source_hash":"0eaf3d7419eaa179c20fb6aefb2deae5ba916fe1050e5858a759662c9e8ce8b6","is_featured":false,"content_group_id":{"id":2551,"is_a":["meta","content_group"],"name":"content_group_imported_docs","title":"Imported documentation","uri":"https:\/\/zotonic.com\/id\/content_group_imported_docs"},"category_id":{"id":320,"is_a":["meta","category"],"name":"module","title":"Modules","uri":"https:\/\/test.zotonic.com\/id\/320"},"doc_source_path":"apps\/zotonic_mod_audio\/src\/mod_audio.erl","publication_start":"2023-06-24T08:17:46Z","github_url":"https:\/\/github.com\/zotonic\/zotonic\/blob\/master\/apps\/zotonic_mod_audio\/src\/mod_audio.erl","pivot_location_lng":null,"doc_source_kind":"module","name":"doc_module_mod_audio","is_unfindable":false,"is_published":true,"pivot_geocode":null,"created":"2020-08-19T11:39:57Z","uri":null,"doc_status":"current","is_dependent":false,"erlang_app":"zotonic_mod_audio","publication_end":"9999-06-01T00:00:00Z","modifier_id":{"id":1,"is_a":["person"],"name":"administrator","title":"Site Administrator","uri":"https:\/\/zotonic.com\/id\/1"},"privacy":0,"doc_source_commit":"92d27433689eef55504265c6dd5486c65dd73483\n","creator_id":{"id":336,"is_a":["person","robot"],"name":"gitbot","title":"Git","uri":"https:\/\/zotonic.com\/id\/336"},"modified":"2026-10-13T15:40:13Z","title_slug":"mod_audio"},"uri":"https:\/\/zotonic.com\/id\/2188","uri_template":"https:\/\/zotonic.com\/id\/:id","websub":{"hub":"https:\/\/zotonic.com\/.zotonic\/websub","topic":"https:\/\/zotonic.com\/.zotonic\/websub\/topic\/2188"}},"status":"ok"}