diff --git a/README.md b/README.md index 1ca1fc4..38a100e 100644 --- a/README.md +++ b/README.md @@ -2,6 +2,6 @@ # Marker Toolbox -Marker Toolbox allows you to import **Vimeo** `CSV`, **Wipster** `CSV`, **Dropbox Replay** `JSON`, Frame.io `FIOJSON` & **Text Comments** into Apple's [Final Cut Pro](https://www.apple.com/final-cut-pro/) and Blackmagic's [DaVinci Resolve](https://www.blackmagicdesign.com/products/davinciresolve){target="_blank"}. +Marker Toolbox allows you to import **Vimeo** `CSV`, **Wipster** `CSV`, **Dropbox Replay** `JSON`, Frame.io `FIOJSON` & **Text Comments** into Apple's [Final Cut Pro](https://www.apple.com/final-cut-pro/) and Blackmagic's [DaVinci Resolve](https://www.blackmagicdesign.com/products/davinciresolve). **You can download & learn more here: [https://markertoolbox.io](https://markertoolbox.io)** \ No newline at end of file diff --git a/docs/README.md b/docs/README.md index 10eee52..de8a0cd 100644 --- a/docs/README.md +++ b/docs/README.md @@ -1,6 +1,6 @@ # Marker Toolbox -Marker Toolbox allows you to import a **Vimeo** `CSV`, **Wipster** `CSV`, **Dropbox Replay** `JSON`, **Frame.io** `FIOJSON` (including from the [V4 Beta](https://frame.io/v4)), **Timecode+** `TSV` & **Text Comments** into Apple's [Final Cut Pro](https://www.apple.com/final-cut-pro/), Blackmagic's [DaVinci Resolve](https://www.blackmagicdesign.com/products/davinciresolve){target="_blank"} and [Avid Media Composer](https://www.avid.com/media-composer){target="_blank"}. +Marker Toolbox allows you to import a **Adobe Premiere** `CSV`, **Vimeo** `CSV`, **Wipster** `CSV`, **Dropbox Replay** `JSON`, **Frame.io** `FIOJSON` (including from the [V4 Beta](https://frame.io/v4)), **Timecode+** `TSV` & **Text Comments** into Apple's [Final Cut Pro](https://www.apple.com/final-cut-pro/), Blackmagic's [DaVinci Resolve](https://www.blackmagicdesign.com/products/davinciresolve) and [Avid Media Composer](https://www.avid.com/media-composer). You can even get OpenAI's **ChatGPT** to help interpret your Text Comments - which is perfect for handling emails from clients! diff --git a/docs/_includes/latenite/commandpost.md b/docs/_includes/latenite/commandpost.md index ac63ee9..75db237 100644 --- a/docs/_includes/latenite/commandpost.md +++ b/docs/_includes/latenite/commandpost.md @@ -1,22 +1,22 @@ ### CommandPost -CommandPost is a **free** and [open source](https://github.com/CommandPost/CommandPost/blob/develop/LICENSE.md){target="_blank"} macOS application that bridges between control surfaces and software that doesn’t support them natively, such as Apple’s [Final Cut Pro](https://www.apple.com/final-cut-pro/){target="_blank"} and Adobe’s [After Effects](https://www.adobe.com/products/aftereffects.html){target="_blank"}. +CommandPost is a **free** and [open source](https://github.com/CommandPost/CommandPost/blob/develop/LICENSE.md) macOS application that bridges between control surfaces and software that doesn’t support them natively, such as Apple’s [Final Cut Pro](https://www.apple.com/final-cut-pro/) and Adobe’s [After Effects](https://www.adobe.com/products/aftereffects.html). ![](../static/commandpost-hero.png) -It’s been downloaded over [163 thousand times](https://hanadigital.github.io/grev/?user=commandpost&repo=commandpost){target="_blank"}, and there are over [2.6 thousands members](https://www.facebook.com/groups/commandpost/members){target="_blank"} in our [Facebook Community](https://www.facebook.com/groups/commandpost/){target="_blank"}. +It’s been downloaded over [163 thousand times](https://hanadigital.github.io/grev/?user=commandpost&repo=commandpost), and there are over [2.6 thousands members](https://www.facebook.com/groups/commandpost/members) in our [Facebook Community](https://www.facebook.com/groups/commandpost/). -It’s been translated into Arabic, Bengali, Catalan, Chinese (Simplified & Traditional), Danish, Dutch, French, German, Greek, Hindi, Hungarian, Italian, Japanese, Korean, Malayalam, Norwegian, Panjabi/Punjabi, Polish, Portuguese, Russian, Spanish, Swedish, Ukrainian & Vietnamese by [our awesome community](https://poeditor.com/join/project/QWvOQlF1Sy){target="_blank"}. +It’s been translated into Arabic, Bengali, Catalan, Chinese (Simplified & Traditional), Danish, Dutch, French, German, Greek, Hindi, Hungarian, Italian, Japanese, Korean, Malayalam, Norwegian, Panjabi/Punjabi, Polish, Portuguese, Russian, Spanish, Swedish, Ukrainian & Vietnamese by [our awesome community](https://poeditor.com/join/project/QWvOQlF1Sy). It’s used by filmmakers, developers, scientists and macOS power users all over the world to seriously speed up mundane tasks through powerful and customisable automation tools. For example, you can apply individual effects within Final Cut Pro or After Effects with the single tap of a button. -Powered by [Lua](https://dev.commandpost.io/lua/overview/){target="_blank"} (the same scripting language used by [Blackmagic Fusion](https://www.blackmagicdesign.com/products/fusion/){target="_blank"}, [Adobe Lightroom](https://www.adobe.com/au/products/photoshop-lightroom.html){target="_blank"} and even parts of [Apple iOS](https://twitter.com/_inside/status/1026173832527265792){target="_blank"}), it's insanely customisable and powerful. +Powered by [Lua](https://dev.commandpost.io/lua/overview/) (the same scripting language used by [Blackmagic Fusion](https://www.blackmagicdesign.com/products/fusion/), [Adobe Lightroom](https://www.adobe.com/au/products/photoshop-lightroom.html) and even parts of [Apple iOS](https://twitter.com/_inside/status/1026173832527265792)), it's insanely customisable and powerful. -It runs natively on Apple Silicon and is fully compatible with [Hammerspoon](http://www.hammerspoon.org){target="_blank"}. +It runs natively on Apple Silicon and is fully compatible with [Hammerspoon](http://www.hammerspoon.org). -You can listen to Chris explain CommandPost on Final Cut Pro Radio [Episode #57](http://fcpradio.com/episode057.html){target="_blank"} and [Episode #43](http://fcpradio.com/episodes/episode043.html){target="_blank"}. +You can listen to Chris explain CommandPost on Final Cut Pro Radio [Episode #57](http://fcpradio.com/episode057.html) and [Episode #43](http://fcpradio.com/episodes/episode043.html). [!button text="Visit Website" target="blank" variant="info"](https://commandpost.io) @@ -25,31 +25,31 @@ You can listen to Chris explain CommandPost on Final Cut Pro Radio [Episode #57] #### User Quotes > _“ Titles to Keywords is a huge timesaver when editing complex scenes. Couldn’t live without it anymore. And directors love that every delivery of any line from any take is just one click away! ”_
-> **[Knut Hake](http://www.knuthake.de){target="_blank"}** - _Editor on Netflix's Blood Red Sky_ +> **[Knut Hake](http://www.knuthake.de)** - _Editor on Netflix's Blood Red Sky_ > _“ CommandPost and FCP are so intertwined on my day to day that I see them as one app! ”_
-> **[Marcos Castiel BFE](http://www.marcoscastiel.com/){target="_blank"}** - _Editor on Netflix's Turn of the Tide_ +> **[Marcos Castiel BFE](http://www.marcoscastiel.com/)** - _Editor on Netflix's Turn of the Tide_ > _“ Command Post started as a FCPX utility but it goes further than that. You can use it to map almost any function to supported hardware devices to work with any app like a BMD Speed Editor and Avid Media Composer! ”_
-> **[Marc Bach](https://www.interfacelab.tv){target="_blank"}** - _Editor & Colourist_ +> **[Marc Bach](https://www.interfacelab.tv)** - _Editor & Colourist_ > _“ Chris's support is the best you will find anywhere on the planet. He was proactive and able to implement features for me on the spot. 5 STAR product 5 STAR support. ControllerMate is what I used to use. CommandPost is faster and easier. ”_
-> **[Ross Batten](https://www.roscoaudio.com.au){target="_blank"}** - _Senior Sound Designer (ProTools)_ +> **[Ross Batten](https://www.roscoaudio.com.au)** - _Senior Sound Designer (ProTools)_ > _“ Search Console is like Spotlight on steroids. It can quickly find and execute any obscure command, NLE and OS-wide, fire up keyboard makros (scripts), and especially, find and place Effects and Effect Templates, directly onto selected clips in my FCP timeline. It constantly saves me clicks. ”_
-> **[Florian Duffe](https://florian-duffe.de/en/flow-en/){target="_blank"}** - _Editor_ +> **[Florian Duffe](https://florian-duffe.de/en/flow-en/)** - _Editor_ > _“ CommandPost is so many things for so many people. For me it is a Final Cut Pro automation system that unlocks hidden features and uniquely supports advanced workflows. CommandPost’s secret weapon? Deep connections with the postproduction community which mean that it constantly improves as the needs of editors and post professionals evolve. ”_
-> **[Alex ‘4D’ Gollner](https://alex4d.com){target="_blank"}** - _Motion Template Creator_ +> **[Alex ‘4D’ Gollner](https://alex4d.com)** - _Motion Template Creator_ > _“ Chris, you have no idea how helpful your Titles to Keywords toolbox has been on our latest production. Without the toolbox these 2-3 hour long timelines (around 900 keywords) would have been nearly impossible to tag with the FCP built in way. It's very long scenes with around 50 lines of text for all characters. ”_
-> **[Sam Pluemacher](https://www.imdb.com/name/nm10223233/){target="_blank"}** - _Assistant Editor on Netflix's Blood Red Sky_ +> **[Sam Pluemacher](https://www.imdb.com/name/nm10223233/)** - _Assistant Editor on Netflix's Blood Red Sky_ > _“ As someone who doesn’t like clicking to do things, CommandPost makes my work much more likeable! ”_
-> **[Oli Frost](https://olifro.st/){target="_blank"}** - _Editor_ +> **[Oli Frost](https://olifro.st/)** - _Editor_ > _“ CommandPost supports my Loupedeck, Stream Deck and Razer devices with advanced Final Cut Pro integrations. Eliminating the need for multiple apps and reducing complexity. ”_
-> **[Sam Pluemacher](https://www.imdb.com/name/nm10223233/){target="_blank"}** - _Assistant Editor on Netflix's Blood Red Sky_ +> **[Sam Pluemacher](https://www.imdb.com/name/nm10223233/)** - _Assistant Editor on Netflix's Blood Red Sky_ > _“ CommandPost is the first thing you should install If you like to tinker. This genius app extends Final Cut Pro in all kinds of ways, enabling advanced workflows, automation, and even integration with external hardware such as MIDI controllers. Recommended. ”_
-> **[Iain Anderson](https://iain-anderson.com){target="_blank"}** - _Author of Final Cut Pro Efficient Editing_ \ No newline at end of file +> **[Iain Anderson](https://iain-anderson.com)** - _Author of Final Cut Pro Efficient Editing_ \ No newline at end of file diff --git a/docs/_includes/latenite/latenite-technology.md b/docs/_includes/latenite/latenite-technology.md index e50945a..42cc21e 100644 --- a/docs/_includes/latenite/latenite-technology.md +++ b/docs/_includes/latenite/latenite-technology.md @@ -1,6 +1,6 @@ # LateNite Technology -This website has been thrown together by [Chris Hocking](https://twitter.com/chrisatlatenite){target="_blank"} at [LateNite](https://latenitefilms.com/technology){target="_blank"}. +This website has been thrown together by [Chris Hocking](https://twitter.com/chrisatlatenite) at [LateNite](https://latenitefilms.com/technology). Constantly looking for ways to innovate, LateNite is as passionate about production and post production as it is storytelling. Their pursuit of creative excellence has seen them work closely with global cinematic technology companies to craft post workflow solutions and critically celebrated software in-house. diff --git a/docs/_includes/latenite/marker-toolbox.md b/docs/_includes/latenite/marker-toolbox.md index 6416522..8f7acef 100644 --- a/docs/_includes/latenite/marker-toolbox.md +++ b/docs/_includes/latenite/marker-toolbox.md @@ -28,7 +28,7 @@ Marker Toolbox requires Final Cut Pro 10.6.5 or later. :::review I’ve been absolutely flatout while working in Thailand. -[Wipsters](https://www.wipster.io){target="_blank"} has been been great, helping me manage projects and reviewers across four countries. Stoked [Marker Toolbox](https://markertoolbox.io){target="_blank"} can send Wipster notes straight into #fcpx +[Wipsters](https://www.wipster.io) has been been great, helping me manage projects and reviewers across four countries. Stoked [Marker Toolbox](https://markertoolbox.io) can send Wipster notes straight into #fcpx _Alister Robbie via [Twitter](https://twitter.com/alisterrobbie/status/1664105856475238400)_ ::: diff --git a/docs/buy.md b/docs/buy.md index 1aa8aed..3270b09 100644 --- a/docs/buy.md +++ b/docs/buy.md @@ -1,15 +1,17 @@ # Buy on Mac App Store -> [:icon-desktop-download: Click here to **buy** on the Mac App Store](https://apps.apple.com/us/app/marker-toolbox/id6446810965){target="_blank"} +> [:icon-desktop-download: Click here to **buy** on the Mac App Store](https://apps.apple.com/us/app/marker-toolbox/id6446810965) -**Marker Toolbox** is a one-time payment of **19.99**. +**Marker Toolbox** is a one-time payment of **USD49.99**. -This is generally **19.99** in your local currency (i.e. **AUD19.99**, **USD19.99**, **CAD19.99**). +There is currently **no free trial**, and it is only be available on the Mac App Store as a **one-time payment**. -However, if your country doesn't have an equivalent of **19.99** (i.e. **Rp349,000** in Indonesia), it will default to a **USD$19.99 equivalent**. +You can find information about Educational Pricing [here](https://markertoolbox.io/educational/). -There is currently **no free trial**, and it is only be available on the Mac App Store as a **one-time payment**. +--- + +## Pricing History -You can find information about Educational Pricing [here](https://markertoolbox.io/educational/){target="_blank"}. +Thank you to all our beta testers and early adopters, who were able to purchase Marker Toolbox for **50% off** during the first week of its release! -Thank you to all our beta testers and early adopters, who were able to purchase Marker Toolbox for 50% off during the first week of its release! \ No newline at end of file +On 2nd August 2024 we increased the pricing from $19.99 (in your local currency) to USD$49.99 due to the small amount of users, and amount of time needed for the v1.4.0 update. \ No newline at end of file diff --git a/docs/credits.md b/docs/credits.md index da914cd..aef82b3 100644 --- a/docs/credits.md +++ b/docs/credits.md @@ -1,16 +1,44 @@ # Credits -Marker Toolbox has been thrown together by [Chris Hocking](https://github.com/latenitefilms){target="_blank"} at [LateNite Films](https://latenitefilms.com){target="_blank"}. +Marker Toolbox has been thrown together by [Chris Hocking](https://github.com/latenitefilms) at [LateNite](https://latenitefilms.com). -Chris also created [CommandPost](https://commandpost.io){target="_blank"}, [BRAW Toolbox](https://brawtoolbox.io){target="_blank"} and [Gyroflow Toolbox](https://gyroflowtoolbox.io){target="_blank"}. +Chris also created [CommandPost](https://commandpost.io), [BRAW Toolbox](https://brawtoolbox.io) and [Gyroflow Toolbox](https://gyroflowtoolbox.io). -The BRAW Toolbox icon was designed by the amazing [Matthew Skiles](http://matthewskiles.com/){target="_blank"}. +The Marker Toolbox icon was designed by the amazing [Matthew Skiles](http://matthewskiles.com/). -Marker Toolbox uses [CHCSVParser](https://github.com/davedelong/CHCSVParser){target="_blank"}. Thanks [davedelong](https://github.com/davedelong){target="_blank"}! +Marker Toolbox uses [TimecodeKit](https://github.com/orchetect/TimecodeKit) for Timecode Handling. Thanks [Steffan Andrews](https://github.com/orchetect)! + +Marker Toolbox uses [CHCSVParser](https://github.com/davedelong/CHCSVParser). Thanks [davedelong](https://github.com/davedelong)! + +--- + +## TimecodeKit + +MIT License + +Copyright (c) 2018 Steffan Andrews - https://github.com/orchetect + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. --- -CHCSVParser +## CHCSVParser Copyright (c) 2014 Dave DeLong diff --git a/docs/educational.md b/docs/educational.md index 7c9eb0c..110f4e4 100644 --- a/docs/educational.md +++ b/docs/educational.md @@ -1,5 +1,5 @@ # Educational Pricing -Educational institutions can get a **50% discount** when they purchase 20 or more copies through [Apple School Manager](https://support.apple.com/en-au/guide/apple-school-manager/welcome/web){target="_blank"}. +Educational institutions can get a **50% discount** when they purchase 20 or more copies through [Apple School Manager](https://support.apple.com/en-au/guide/apple-school-manager/welcome/web). -Please [contact Apple](https://support.apple.com/contact){target="_blank"} if you need help with Educational Pricing. \ No newline at end of file +Please [contact Apple](https://support.apple.com/contact) if you need help with Educational Pricing. \ No newline at end of file diff --git a/docs/faq.md b/docs/faq.md index 834a3f9..952a945 100644 --- a/docs/faq.md +++ b/docs/faq.md @@ -1,5 +1,28 @@ # Frequently Asked Questions +### Can I import my own CSV format? + +Yes, but you need to match an existing CSV format that Marker Toolbox supports. + +For example, here are some headers of the CSV formats we support: + +**Adobe Premiere:** +``` +Start Time,End Time,Text,Layer ID +``` + +**Vimeo:** +``` +"Video Version","#","Timecode","Name","Note","Reply","Date Added","Resolved" +``` + +**Wipster:** +``` +Title,Version,Timecode,Thread Id,Comment Type,Reply,Created By,Creation Date & Time,Comment,Task Completed +``` + +--- + ### Why do we need to supply our own OpenAI API Key? To keep Marker Toolbox as a one-off payment on the Mac App Store, we have decided that if you want to use the ChatGPT features in Marker Toolbox, you'll need to supply your own API key. @@ -12,14 +35,14 @@ You can set up a **free** OpenAI account, which gives you **$5** in free credit After the first three months, OpenAI charges per 1000 tokens. You can think of tokens as pieces of words, where 1,000 tokens is about 750 words. -Once you have a OpenAI account, you can generate API keys [here](https://platform.openai.com/account/api-keys){target="_blank"}. +Once you have a OpenAI account, you can generate API keys [here](https://platform.openai.com/account/api-keys). -You can learn more about OpenAI's pricing [here](https://openai.com/pricing){target="_blank"}. +You can learn more about OpenAI's pricing [here](https://openai.com/pricing). --- ### Does this work with any iPhone/iPad Logging Apps? -Yes, you can use third party iPhone apps, such as [Timecode+](https://apps.apple.com/app/id590534084){target="_blank"}. +Yes, you can use third party iPhone apps, such as [Timecode+](https://apps.apple.com/app/id590534084). Simply **Share as Text** in the Timecode+ App, then use the **Paste** button in Marker Toolbox to paste the text, and then **Process Comments Locally**. \ No newline at end of file diff --git a/docs/how-to-use.md b/docs/how-to-use.md index 07948e8..08a39c1 100644 --- a/docs/how-to-use.md +++ b/docs/how-to-use.md @@ -132,11 +132,17 @@ These settings should be applied **before** you import a `FIOJSON`. If you chang ### Convert Vimeo CSV to Markers +Vimeo uses the following CSV header: + +``` +"Video Version","#","Timecode","Name","Note","Reply","Date Added","Resolved" +``` + This feature allows you to easily import Vimeo `CSV` as markers and titles in Final Cut Pro. -You can learn more about exporting `CSV` files from Vimeo [here](https://vimeo.zendesk.com/hc/en-us/articles/224818367-Video-review-page-){target="_blank"}. +You can learn more about exporting `CSV` files from Vimeo [here](https://vimeo.zendesk.com/hc/en-us/articles/224818367-Video-review-page-). -This functionality has been built into [CommandPost](https://commandpost.io){target="_blank"} for a while, however we've improved upon it based on user feedback. +This functionality has been built into [CommandPost](https://commandpost.io) for a while, however we've improved upon it based on user feedback. Once exported, simply drag a `CSV` file into the drop zone, or click the **Select File** button: @@ -182,13 +188,19 @@ These settings should be applied **before** you import a `CSV`. If you change th ### Convert Wipster CSV to Markers +Wipster uses the following CSV header: + +``` +Title,Version,Timecode,Thread Id,Comment Type,Reply,Created By,Creation Date & Time,Comment,Task Completed +``` + This feature allows you to easily import a Wipster `CSV` as markers and titles in Final Cut Pro. You can export a `CSV` from Wipster, by clicking the **Download** button on your video, then the **Export CSV** option. ![_Screenshot of Wipster_](static/wipster.png) -You can learn more about exporting `CSV` files from Wipster [here](https://intercom.help/wipster-support/en/articles/3350841-can-i-print-out-the-comments-on-my-video-or-image){target="_blank"}. +You can learn more about exporting `CSV` files from Wipster [here](https://intercom.help/wipster-support/en/articles/3350841-can-i-print-out-the-comments-on-my-video-or-image). Once exported, simply drag a `CSV` file into the drop zone, or click the **Select File** button: @@ -232,9 +244,68 @@ These settings should be applied **before** you import a `CSV`. If you change th --- +### Convert Adobe Premiere CSV to Markers + +Adobe Premiere uses the following CSV header: + +``` +Start Time,End Time,Text,Layer ID +``` + +This feature allows you to easily import a Adobe Premiere `CSV` as markers and titles in Final Cut Pro. + +You can learn more about exporting `CSV` files from Adobe Premiere [here](https://helpx.adobe.com/au/premiere-pro/using/export-text-captions.html). + +Once exported, simply drag a `CSV` file into the drop zone, or click the **Select File** button: + +![](static/top-section.png) + +Assuming the `CSV` is correct and valid, the draggable icon on the bottom of the interface will now be green: + +![](static/drag.png) + +You can now drag this green icon into your Final Cut Pro timeline or browser. + +Alternatively, you can also click the **Save File** button, and export a: + +- Final Cut Pro `FCPXML` +- Resolve `EDL` +- Avid Media Composer Marker Text. + +![](static/save-file.png) + +If you drag the icon to your timeline, a **Compound Clip** with all your markers will be added: + +![](static/timeline.png) + +You can then use the **Clip > Break Apart Clip Items** menubar item to break the Compound Clip into individual markers: + +![](static/break-apart-clip-items.png) + +This is handy because the individual markers will now be attached to the clips on the Primary Storyline, so that when you re-arrange clips, those markers will travel with them. + +![](static/timeline-break-apart.png) + +Back in the Workflow Extension if you click the **Settings** button, you can set the Frame Rate and what information is used for the Marker Name: + +![](static/top-settings.png) + +These settings should be applied **before** you import a `CSV`. If you change them, you should import your `CSV` again for the `FCPXML` to be updated. + +--- + ### Convert Timecode+ TSV to Markers -This feature allows you to easily import a [Timecode+](https://apps.apple.com/au/app/timecode-cameraman/id590534084){target="_blank"} `TSV` file as markers and titles in Final Cut Pro. +TSV files have the following format: + +``` +NAME Description Apr 14 2023 02:48 + +Time Note +00:01:06:00 Your note goes here +``` + +This feature allows you to easily import a [Timecode+](https://apps.apple.com/au/app/timecode-cameraman/id590534084) `TSV` file as markers and titles in Final Cut Pro. Simply drag a `TSV` file into the drop zone, or click the **Select File** button: @@ -303,11 +374,11 @@ However, if you have a more complicated collection of feedback, you can use Open ![](static/email-comments.png) -To use the ChatGPT functionality you'll need to supply your own [OpenAI API key](https://platform.openai.com/account/api-keys){target="_blank"}.. +To use the ChatGPT functionality you'll need to supply your own [OpenAI API key](https://platform.openai.com/account/api-keys).. You can set up a OpenAI account for **free**, and you'll get a limited number of tokens. You can find OpenAI's pricing [here](https://openai.com/pricing). -If you have a ChatGPT account, you can [get your API key here](https://platform.openai.com/account/api-keys){target="_blank"}. +If you have a ChatGPT account, you can [get your API key here](https://platform.openai.com/account/api-keys). You can enter your OpenAI API Key in the Settings panel: @@ -315,7 +386,7 @@ You can enter your OpenAI API Key in the Settings panel: Pressing the **Get API Key** button in the user interface, will open up the same above link. -Your API key is securely saved in [macOS's Keychain](https://support.apple.com/en-au/guide/keychain-access/kyca1083/mac){target="_blank"}. +Your API key is securely saved in [macOS's Keychain](https://support.apple.com/en-au/guide/keychain-access/kyca1083/mac). If you copy the API key from the OpenAI website, you can use the **Paste API Key** to paste it. @@ -333,7 +404,7 @@ Depending on OpenAI's server load, this process can happen quickly, or take a fe ![](static/waiting.png) -You can check the OpenAI Server Status [here](https://status.openai.com){target="_blank"}. +You can check the OpenAI Server Status [here](https://status.openai.com). Once complete, you can now drag the green icon into your Final Cut Pro timeline or browser. @@ -353,7 +424,7 @@ You can also customise the ChatGPT Model, Frame Rate and Prompt by clicking the The default ChatGPT Model is **gpt-3.5-turbo**. If you have access to **gpt-3.5-turbo-16k**, **gpt-4** or **gpt-4-32k** you can also select them. -You can learn more about the various ChatGPT models [here](https://platform.openai.com/docs/models){target="_blank"}. +You can learn more about the various ChatGPT models [here](https://platform.openai.com/docs/models). The Frame Rate dropdown allows you to select the frame rate of your destination timeline/project. It's **25fps** by default. @@ -368,11 +439,11 @@ The default prompt is: > > The JSON format should be as follows: > -> [{\"timestamp\":\"\",\"comment\":\"\"},...] +> [{\"framecount\":\"\",\"comment\":\"\"},...] > -> The value should never be below zero. +> The value should never be below zero. > -> SMPTE timecode values (i.e. \"HH:MM:SS:FF\" for hours, minutes, seconds and frames), should be converted into seconds. +> SMPTE timecode values (i.e. \"HH:MM:SS:FF\" for hours, minutes, seconds and frames), should be converted into a frame count. > > The frame rate of all SMTPE timecode values, and frame explanations (i.e. '300 frames later') should be . > @@ -391,20 +462,20 @@ The default prompt is: > Your reply should be: > > [ -> {\"timestamp\":\"1\", \"comment\":\"I really like this shot\"}, +> {\"timestamp\":\"25\", \"comment\":\"I really like this shot\"}, > {\"timestamp\":\"2\", \"comment\":\"Please remove this shot\"}, -> {\"timestamp\":\"83\", \"comment\":\"Fix this window\"}, -> {\"timestamp\":\"300\", \"comment\":\"Remove the cat\"}, -> {\"timestamp\":\"600\", \"comment\":\"Replace this shot\"} -> {\"timestamp\":\"0.04\", \"comment\":\"Add a sound effect here\"} -> {\"timestamp\":\"6\", \"comment\":\"I really like the shot\"} -> {\"timestamp\":\"16\", \"comment\":\"Something really cool happens\"} -> {\"timestamp\":\"0.48\", \"comment\":\"Insert monkey\"} +> {\"timestamp\":\"2075\", \"comment\":\"Fix this window\"}, +> {\"timestamp\":\"7500\", \"comment\":\"Remove the cat\"}, +> {\"timestamp\":\"15000\", \"comment\":\"Replace this shot\"} +> {\"timestamp\":\"1\", \"comment\":\"Add a sound effect here\"} +> {\"timestamp\":\"150\", \"comment\":\"I really like the shot\"} +> {\"timestamp\":\"400\", \"comment\":\"Something really cool happens\"} +> {\"timestamp\":\"12\", \"comment\":\"Insert monkey\"} > ] > > Please be careful about whether a timecode value is relative to the previous comment's timecode value (i.e. '10 seconds later') and calculate accordingly. > -> If there is a general note with no timecode or timing value, please use a 0 second timestamp value. +> If there is a general note with no timecode or timing value, please use a 0 frame count value. > > Please process the below notes: > diff --git a/docs/installation.md b/docs/installation.md index 3d9af32..42ba082 100644 --- a/docs/installation.md +++ b/docs/installation.md @@ -1,6 +1,6 @@ # Installation -To install **Marker Toolbox**, simply download it from the [Mac App Store](https://apps.apple.com/us/app/marker-toolbox/id6446810965){target="_blank"}, and open it once downloaded. +To install **Marker Toolbox**, simply download it from the [Mac App Store](https://apps.apple.com/us/app/marker-toolbox/id6446810965), and open it once downloaded. ![](static/install.png) diff --git a/docs/privacy.md b/docs/privacy.md index ad4d8eb..ce82169 100644 --- a/docs/privacy.md +++ b/docs/privacy.md @@ -10,16 +10,16 @@ If you supply an OpenAI API key, Marker Toolbox can communicate with the OpenAI The only information that is securely sent to the OpenAI API is the supplied email comments, and your API key (which is stored securely on Apple's Keychain). -You can learn more about OpenAI's API [here](https://platform.openai.com/docs/api-reference){target="_blank"}. +You can learn more about OpenAI's API [here](https://platform.openai.com/docs/api-reference). -You can read OpenAI's Privacy Policy [here](https://openai.com/policies/privacy-policy){target="_blank"}. +You can read OpenAI's Privacy Policy [here](https://openai.com/policies/privacy-policy). Apple may collect and use certain usage and performance data from the apps that are available on the App Store. This data is used to help improve the App Store and the overall user experience. This data collection is not specific to any individual user, and it is not possible for app developers to opt out of this data collection by Apple. -You can read Apple's App Store Privacy Policy [here](https://www.apple.com/legal/privacy/data/en/app-store/){target="_blank"}. +You can read Apple's App Store Privacy Policy [here](https://www.apple.com/legal/privacy/data/en/app-store/). -We use this GitHub Repository for documentation hosting and technical support. You can read GitHub's Privacy Policy [here](https://docs.github.com/en/site-policy/privacy-policies/github-privacy-statement){target="_blank"}. +We use this GitHub Repository for documentation hosting and technical support. You can read GitHub's Privacy Policy [here](https://docs.github.com/en/site-policy/privacy-policies/github-privacy-statement). -If you have any questions or concerns, you can [submit an issue](https://github.com/latenitefilms/Markertoolbox/issues){target="_blank"}, or email us: support@latenitefilms.com \ No newline at end of file +If you have any questions or concerns, you can [submit an issue](https://github.com/latenitefilms/Markertoolbox/issues), or email us: support@latenitefilms.com \ No newline at end of file diff --git a/docs/release-notes.md b/docs/release-notes.md index 0120917..d6e0126 100644 --- a/docs/release-notes.md +++ b/docs/release-notes.md @@ -1,5 +1,20 @@ # Release Notes +### v1.4.0 (18) + +**🎉 Released:** +- 2nd August 2024 + +**🔨 Improvements:** +- Added support for Adobe Premiere CSVs. Thanks Michael Angelo! +- Wipster CSV support has been improved. We now display replies properly. +- Frame.io FIOJSON support has been improved. The markers on 29.97fps projects should now more accurately match the Frame.io website. Thanks Shih-Cheng Yang! +- All of the timecode processing logic and maths has been completely redesigned and rewritten, so that we can better support all frame rates, and ensure everything is frame accurate. We now use TimecodeKit for timecode handling. HUGE thanks to Steffan Andrews for his incredible work! +- The default ChatGPT prompt has been updated to work in frames, rather than seconds for better accuracy. If you have a custom prompt, you should press the "Reset Prompt" button in the bottom settings to update the prompt to the new format. +- The latest OpenAI ChatGPT models are now supported. + +--- + ### v1.3.2 (17) **🎉 Released:** diff --git a/docs/support.md b/docs/support.md index 389a414..d7701f8 100644 --- a/docs/support.md +++ b/docs/support.md @@ -1,11 +1,11 @@ # Support -If you run into any bugs, crashes, or you have a feature request, you can post an issue [here](https://github.com/latenitefilms/markertoolbox/issues){target="_blank"}. +If you run into any bugs, crashes, or you have a feature request, you can post an issue [here](https://github.com/latenitefilms/markertoolbox/issues). -If you have any general questions or feedback, you can discuss [here](https://github.com/latenitefilms/markertoolbox/discussions){target="_blank"}. +If you have any general questions or feedback, you can discuss [here](https://github.com/latenitefilms/markertoolbox/discussions). -GitHub registration is free, and this GitHub repository is actively monitored by [LateNite Films](https://github.com/latenitefilms){target="_blank"}. +GitHub registration is free, and this GitHub repository is actively monitored by [LateNite Films](https://github.com/latenitefilms). You can also email us: [support@latenitefilms.com](mailto:support@latenitefilms.com?subject=Marker%20Toolbox%20Support) -We're based in **Melbourne, Australia** - you can check the timezone [here](https://www.timeanddate.com/worldclock/australia/melbourne){target="_blank"}. \ No newline at end of file +We're based in **Melbourne, Australia** - you can check the timezone [here](https://www.timeanddate.com/worldclock/australia/melbourne). \ No newline at end of file diff --git a/docs/system-requirements.md b/docs/system-requirements.md index 8399f98..aa059da 100644 --- a/docs/system-requirements.md +++ b/docs/system-requirements.md @@ -4,4 +4,4 @@ Marker Toolbox runs as a standalone application. The Marker Toolbox Workflow Extension requires **Final Cut Pro 10.6.5** or later (including **Final Cut Pro 10.6.6**). -You can find Final Cut Pro's system requirements [here](https://www.apple.com/au/final-cut-pro/specs/){target="_blank"}. \ No newline at end of file +You can find Final Cut Pro's system requirements [here](https://www.apple.com/au/final-cut-pro/specs/). \ No newline at end of file