https://github.com/theacharya/markerdata
The avant-garde Marker extraction application crafted for Final Cut Pro
https://github.com/theacharya/markerdata
airtable colour-palette csv database fcp fcpx fcpxml final-cut-pro-x finalcutpro gif gifs json macos macos-application markers midi notion swift swiftui video-editing
Last synced: about 1 month ago
JSON representation
The avant-garde Marker extraction application crafted for Final Cut Pro
- Host: GitHub
- URL: https://github.com/theacharya/markerdata
- Owner: TheAcharya
- License: mit
- Created: 2023-01-12T13:05:00.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-02-19T09:52:32.000Z (4 months ago)
- Last Synced: 2025-02-19T10:32:48.711Z (4 months ago)
- Topics: airtable, colour-palette, csv, database, fcp, fcpx, fcpxml, final-cut-pro-x, finalcutpro, gif, gifs, json, macos, macos-application, markers, midi, notion, swift, swiftui, video-editing
- Language: Swift
- Homepage: https://markerdata.theacharya.co
- Size: 143 MB
- Stars: 41
- Watchers: 3
- Forks: 2
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
Marker Data allows users to extract, convert & create databases from Final Cut Pro’s Marker metadata effortlessly. Marker Data uses MarkersExtractor Library.
## Core Features
- Functionality allowing batch extraction and rendering of stills or animated GIFs based on each Marker's timecode.
- Automatically analyse and embed colour swatches from extracted images for shot reference.
- Integrates with Final Cut Pro, boasting a native Share Destination & Workflow Extension.
- Precise extraction of Markers, ensuring an accurate representation of metadata.
- Native integration with renowned databases such as [Notion](https://www.notion.so) and [Airtable](https://www.airtable.com).
- Effortlessly synchronise Final Cut Pro's Marker metadata to cloud databases with a single click.
- Versatile features for batch burning-in labels, embedding comprehensive metadata of each Marker onto stills or animated GIFs.
- Comprehensive timeline functionality, encompassing support for timelines such as Projects and Compound Clips.
- Allows the creation of multiple configurations tailored to diverse project requirements.
- Harnesses the potential to utilise Captions as Markers, adding a layer of flexibility.
- Written in Apple Swift language and SwiftUI framework.
- Application is Notarised by Apple.
## Avaliable Extract Profiles
- Notion (JSON)
- Airtable (JSON)
- Comma-separated values (CSV) - Compatible with spreadsheet applications
- Tab-separated values (TSV) - Compatible with spreadsheet application
- Microsoft Excel (XLSX)
- YouTube Chapters (TXT)
- Standard MIDI File - Compatible with most audio DAWs
## Table of contents
- [Demo](#demo)
- [Screenshot](#screenshot)
- [System Requirements](#system-requirements)
- [Download](https://github.com/TheAcharya/MarkerData/releases)
- [Installation](#installation)
- [Use Cases](#use-cases)
- [Featured](#Featured)
- [Credits](#Credits)
- [License](#License)
- [Reporting Bugs](#reporting-bugs)
## Demo
Send to Notion
Send to Airtable
Send to Logic Pro
Create YouTube Chapters
Creating Shot Library
Utilising Workflow Extension
Queue in Action
## Screenshot
## System Requirements
macOS Ventura 13.6.7 or later
Final Cut Pro 10.7.1 or later
Runs only on Apple silicon Macs
## Installation
1. Download the DMG to your system.
2. Mount the DMG by double-clicking it.
3. Move Marker Data to your Applications folder.
4. Launch Marker Data.
5. Read Onboarding information and instructions.
6. Create your first [Configuration](https://markerdata.theacharya.co/user-guide/configurations/).
7. Start using Marker Data and have fun!
> [!WARNING]
> Marker Data must be installed in the Applications folder to run correctly. Running the application outside of this designated directory would result in functionality issues.
## Use Cases
- Marker Notes Database
- Shot Library Database
- VFX Database
- ADR Database
- Stock Footage Database
- Music Cue Sheet Database
- Colourist’s Notes Database
- Client Review & Tracking Database
- Offline & Online Notes Database
- Send Final Cut Pro's Markers to DAWs
- Create YouTube Chapters
## Featured
- [FCP Cafe](https://fcp.cafe/ecosystem/tools/#marker-data)
- [Newsshooter](https://www.newsshooter.com/2024/07/10/marker-data-for-final-cut-pro/)
- [ProVideo Coalition](https://www.provideocoalition.com/marker-data-a-quick-look/)
## Credits
Original Idea, Application Direction and Workflow Architecture by [Vigneswaran Rajkumar](https://bsky.app/profile/vigneswaranrajkumar.com)
**Graphical User Interface and UI/UX Logic**
Maintained by [Milán Várady](https://github.com/milanvarady) (1.0.0 ...)
**MarkersExtractor (CLI & Library)**
Maintained by [Steffan Andrews](https://github.com/orchetect) ([0.2.0 ...](https://github.com/TheAcharya/MarkersExtractor))
**App Icon**
Icon Design by [Bor Jen Goh](https://www.artstation.com/borjengoh)
## License
Licensed under the MIT license. See [LICENSE](https://github.com/TheAcharya/MarkerData/blob/main/LICENSE) for details.
## Reporting Bugs
Technical support questions are best asked in the [Discussions](https://github.com/TheAcharya/MarkerData/discussions).
For bug reports, feature requests and other suggestions you can create a new [issue](https://github.com/TheAcharya/MarkerData/issues) to discuss.
