elonen
Feature Request: Export Comments and Notes as Markers for Video Editing Software
Description It would be incredibly helpful if Clapshot could allow users to download comments and notes as markers that can be imported into video editing software like DaVinci Resolve or Adobe Premiere Pro.
Proposed Workflow Users create timestamps, comments, and notes in Clapshot. Provide an option to export these annotations as: A .csv file formatted for easy import into DaVinci Resolve or Adobe Premiere Pro. Other supported formats like .xml for broader compatibility. Users import the exported file into their video editing software, where the comments appear as markers on the timeline. Benefits Streamlines collaboration between teams using Clapshot for review and editors using professional software. Reduces manual work of transferring comments and notes into editing timelines. Enhances efficiency for video production workflows. Examples of Marker Formats DaVinci Resolve:
.csv format with columns like Timecode, Name, Comment, Color. Example:
csv Copy code Timecode,Name,Comment,Color 00:00:10:00,Note 1,"Increase brightness",Red 00:01:20:00,Note 2,"Add transition",Green Adobe Premiere Pro:
.xml format compatible with the timeline markers. Additional Context This feature could be extended to support other tools and formats commonly used in the industry, making Clapshot more versatile.
Is there an XML format that is compatible with all major NLEs for marker import?
Export Comments and Notes as Markers for Video Editing Software Conceptual Approach:
You’d introduce a new server-side endpoint (or organizer command) that, given a media file (or a set of them), returns a standardized list of comments, annotations, or subtitles in a format supported by editing tools (e.g., EDL, FCPXML, CSV markers). The Client UI would add a button to "Export Markers" from the current video.
Integration Points:
Server-side (Rust):
In server/src/api_server or server/src/grpc, add a new gRPC call or HTTP endpoint for exporting markers. This endpoint would query the comments table for the given media_file_id and map each comment’s timecode and comment text to a standard markers format. The code for retrieving comments from the DB is already present in database/tests.rs and db_get_media_files, db_get_comments methods. You can reuse these to fetch and then transform data. Organizer (Python, Basic Folders Example):
If folder logic or organizer logic affects how comments are grouped, you might add a custom command (cmd_from_client) such as "export_markers", passing the media_file_id. Organizer calls srv.DbGetComments(...) then transforms them. Client (Svelte):
Add a button in App.svelte or VideoPlayer.svelte (in client/src/lib/player_view) that calls clapshot.callOrganizer("export_markers", {id: media_file_id}). On response, prompt user to download the resulting file. Data Format:
Decide on a marker export format (CSV with timecode, comment, …) or EDL. After receiving comments, server returns a downloadable file.
Is there an XML format that is compatible with all major NLEs for marker import?
Hi! There is Apple XML document. AFAIK other NLE are tend to support it https://developer.apple.com/library/archive/documentation/AppleApplications/Reference/FinalCutPro_XML/Index/index_of_book.html
