Skip to content

Commit

Permalink
Preparing for 1.3.0 (55)
Browse files Browse the repository at this point in the history
- Fixed links
  • Loading branch information
latenitefilms committed Jul 11, 2023
1 parent f3d39a3 commit 51c7e33
Show file tree
Hide file tree
Showing 19 changed files with 118 additions and 108 deletions.
23 changes: 9 additions & 14 deletions docs/README.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,12 @@
---
label: Welcome
icon: home
order: 10000
---
# BRAW Toolbox

BRAW Toolbox allows you to import Blackmagic RAW files directly into Final Cut Pro **without transcoding**.

**_No more transcoding. No more waiting. No more massive ProRes files._**

BRAW Toolbox is used by over **950** Final Cut Pro editors all around the world!
BRAW Toolbox is used by over **1,150** Final Cut Pro editors from all around the world!

> [:icon-desktop-download: **Click here to buy on the Mac App Store**](https://apps.apple.com/au/app/braw-toolbox/id6444061549?mt=12)
> [:icon-desktop-download: **Click here to buy!**](/buy)
![_Screenshot of BRAW Toolbox in Action. Surf footage by Adrian Emerton._](static/hero-banner.png)

Expand All @@ -33,31 +28,31 @@ Once imported into Final Cut Pro, you can still modify the RAW parameters at any

There are automatic Decode Quality options for both HD and UltraHD projects, and you can also work at a low quality Decode Quality, then apply a **Global Setting** to force Full Quality prior to export. BRAW Toolbox gives you complete freedom and flexibility.

![_Screenshot of BRAW Toolbox in Action._](static/install-18.png)
![](static/install-18.png)

---

## Powerful Metadata

BRAW Toolbox comes with a Metadata View that allows you to view every piece of BRAW Metadata directly within the Final Cut Pro Inspector.

![_Screenshot of BRAW Toolbox in Action._](static/metadata-small.png)
![](static/metadata-small.png)

---

## Gyroscope Stabilisation

You can combine BRAW Toolbox with [Gyroflow Toolbox](https://gyroflowtoolbox.io) to bring gyroscope stabilisation directly to Final Cut Pro!
You can combine BRAW Toolbox with [Gyroflow Toolbox](https://gyroflowtoolbox.io){target="_blank"} to bring gyroscope stabilisation directly to Final Cut Pro!

![_Screenshot of BRAW Toolbox in Action._](static/stabilisation.png)
![](static/stabilisation.png)

---

## Send to DaVinci Resolve

You can also use the Workflow Extension to send your project/timeline to DaVinci Resolve for grading - all using BRAW files directly from the camera!

![_Screenshot of BRAW Toolbox in Action._](static/davinci-resolve.png)
![](static/davinci-resolve.png)

---

Expand All @@ -67,6 +62,6 @@ You can also use the Workflow Extension to send your project/timeline to DaVinci

Since then, BRAW Toolbox has continued to reach the top lists on a regular basis! Thanks for your continued support!

![_Screenshot of the Mac App Store._](static/app-store.png)
![](static/app-store.png)

> [:icon-desktop-download: **Click here to buy on the Mac App Store**](https://apps.apple.com/au/app/braw-toolbox/id6444061549?mt=12)
> [:icon-desktop-download: **Click here to buy!**](/buy)
3 changes: 3 additions & 0 deletions docs/README.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
label: Introduction
icon: home
order: 10000
6 changes: 3 additions & 3 deletions docs/buy.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Buy on Mac App Store

> [:icon-desktop-download: **Click here to buy on the Mac App Store**](https://apps.apple.com/au/app/braw-toolbox/id6444061549?mt=12)
> [:icon-desktop-download: **Click here to buy on the Mac App Store**](https://apps.apple.com/au/app/braw-toolbox/id6444061549?mt=12){target="_blank"}
**BRAW Toolbox** is a one-time payment of **79.99**.

Expand All @@ -10,9 +10,9 @@ However, if your country doesn't have an equivalent of 79.99 (i.e. Rp1,299,000 i

There is currently no free trial, and it is only be available on the Mac App Store as a **one-time payment**.

However, we will be posting TestFlight builds prior to updates for the community to test. Keep an eye on our [announcements](https://github.com/latenitefilms/BRAWToolbox/discussions/categories/announcements).
However, we will be posting TestFlight builds prior to updates for the community to test. Keep an eye on our [announcements](https://github.com/latenitefilms/BRAWToolbox/discussions/categories/announcements){target="_blank"}.

You can find information about Educational Pricing [here](https://brawtoolbox.io/educational/).
You can find information about Educational Pricing [here](/educational).

Thank you to all our beta testers and early adopters, who were able to purchase BRAW Toolbox for 50% off during the first week of its release!

Expand Down
2 changes: 1 addition & 1 deletion docs/collaboration.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ Whilst this is fantastic for security reasons - it does provide challenges for a

When you import clips into the BRAW Toolbox Workflow Extension, you are explicitly giving permission to BRAW Toolbox to access those BRAW files.

Everything works great if you're on a single machine. We use a technology called [security-scoped bookmarks](https://developer.apple.com/documentation/professional_video_applications/fcpxml_reference/asset/media-rep/bookmark/enabling_security-scoped_bookmark_and_url_access?language=objc) to allow us to access any files you've given us permission to access at a later time.
Everything works great if you're on a single machine. We use a technology called [security-scoped bookmarks](https://developer.apple.com/documentation/professional_video_applications/fcpxml_reference/asset/media-rep/bookmark/enabling_security-scoped_bookmark_and_url_access?language=objc){target="_blank"} to allow us to access any files you've given us permission to access at a later time.

However, when it comes to collaboration it gets a bit more tricky, because those bookmarks are specific to the individual machine.

Expand Down
8 changes: 4 additions & 4 deletions docs/credits.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
# Credits

BRAW Toolbox has been thrown together by [Chris Hocking](https://github.com/latenitefilms) at [LateNite Films](https://latenitefilms.com).
BRAW Toolbox has been thrown together by [Chris Hocking](https://github.com/latenitefilms){target="_blank"} at [LateNite Films](https://latenitefilms.com){target="_blank"}.

Chris also created [CommandPost](https://commandpost.io) and [Gyroflow Toolbox](https://github.com/latenitefilms/GyroflowToolbox).
Chris also created [CommandPost](https://commandpost.io){target="_blank"} and [Gyroflow Toolbox](https://github.com/latenitefilms/GyroflowToolbox){target="_blank"}.

The BRAW Toolbox icon was designed by the amazing [Matthew Skiles](http://matthewskiles.com).
The BRAW Toolbox icon was designed by the amazing [Matthew Skiles](http://matthewskiles.com){target="_blank"}.

The incredible surf footage (as seen in the above screenshots) was captured by Sydney based Director/Cinematographer, [Adrian Emerton](https://www.adrianemerton.com.au).
The incredible surf footage (as seen in the above screenshots) was captured by Sydney based Director/Cinematographer, [Adrian Emerton](https://www.adrianemerton.com.au){target="_blank"}.
6 changes: 3 additions & 3 deletions docs/educational.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# 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).
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"}.

Please [contact Apple](https://support.apple.com/contact) if you need help with Educational Pricing.
Please [contact Apple](https://support.apple.com/contact){target="_blank"} if you need help with Educational Pricing.

However, if you're a film student, or in a country where Apple hardware and software is insanely expensive, please don't hesitate to [reach out](https://brawtoolbox.io/support/) for some kind of sponsorship agreement, as we love helping out emerging filmmakers!
However, if you're a film student, or in a country where Apple hardware and software is insanely expensive, please don't hesitate to [reach out](/support) for some kind of sponsorship agreement, as we love helping out emerging filmmakers!
32 changes: 17 additions & 15 deletions docs/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,9 @@

### Why BRAW Toolbox?

[Color Finale Transcoder](https://colorfinale.com/transcoder) allows you to convert BRAW files into ProRes quickly and easily, all via a very slick Workflow Extension. It's a great application that we highly recommend you purchase.
[Color Finale Transcoder](https://colorfinale.com/transcoder){target="_blank"} allows you to convert BRAW files into ProRes quickly and easily, all via a very slick Workflow Extension. It's a great application that we highly recommend you purchase.

There's also the incredible [EditReady](https://hedge.video/editready) which is also fantastic at just converting BRAW to ProRes with lots of power and controls. Again, we recommend everyone purchases it.
There's also the incredible [EditReady](https://hedge.video/editready){target="_blank"} which is also fantastic at just converting BRAW to ProRes with lots of power and controls. Again, we recommend everyone purchases it.

And of course, DaVinci Resolve is free and even has the **Blackmagic Proxy Generator** app to easily convert BRAW to proxies.

Expand All @@ -22,13 +22,13 @@ Now we can just import BRAW files directly into Final Cut Pro, with full RAW con

### How does it work?

Because Final Cut Pro's decode API is private - we had to just make do with the two public API's we had access to - [Workflow Extensions](https://developer.apple.com/documentation/professional_video_applications/workflow_extensions) and [FxPlug4](https://developer.apple.com/documentation/professional_video_applications/fxplug?language=objc).
Because Final Cut Pro's decode API is private - we had to just make do with the two public API's we had access to - [Workflow Extensions](https://developer.apple.com/documentation/professional_video_applications/workflow_extensions){target="_blank"} and [FxPlug4](https://developer.apple.com/documentation/professional_video_applications/fxplug?language=objc){target="_blank"}.

We use the Workflow Extension API as our "user interface", where users can select the footage they want to import, and preset any RAW controls.

We use the FxPlug4 API as our "renderer". Essentially, BRAW Toolbox is just a Filter in Apple Motion, and an Effect in Final Cut Pro, but instead of "processing" the source clip, we replace the clip contents with the processed BRAW clip.

We use Blackmagic's official [BRAW SDK](https://www.blackmagicdesign.com/developer/product/camera) - so you get all the same colour science and processing speed as DaVinci Resolve.
We use Blackmagic's official [BRAW SDK](https://www.blackmagicdesign.com/developer/product/camera){target="_blank"} - so you get all the same colour science and processing speed as DaVinci Resolve.

As far as we know, BRAW Toolbox is the first application on the Mac App Store to include an FxPlug4 effect.

Expand Down Expand Up @@ -62,13 +62,13 @@ For the first week, we released BRAW Toolbox at 50% off as a small thank you to

It was also available a few weeks prior to release as a pre-sale with the 50% discount.

You can find educational pricing [here](https://brawtoolbox.io/educational/).
You can find educational pricing [here](/educational).

We also support and encourage independent filmmakers and film school students to [reach out](https://brawtoolbox.io/support/) if cost becomes an issue.
We also support and encourage independent filmmakers and film school students to [reach out](/support) if cost becomes an issue.

You can always use [DaVinci Resolve](https://www.blackmagicdesign.com/products/davinciresolve) for free if you want to convert BRAW to ProRes to edit in Final Cut Pro.
You can always use [DaVinci Resolve](https://www.blackmagicdesign.com/products/davinciresolve){target="_blank"} for free if you want to convert BRAW to ProRes to edit in Final Cut Pro.

We are also big fans of [Color Finale Transcoder](https://colorfinale.com/transcoder) and [EditReady](https://hedge.video/editready).
We are also big fans of [Color Finale Transcoder](https://colorfinale.com/transcoder){target="_blank"} and [EditReady](https://hedge.video/editready){target="_blank"}.

---

Expand All @@ -78,24 +78,24 @@ Yes, prior to public release BRAW Toolbox was in a public beta from 23rd Decembe

MASSIVE thanks to the **291 users** who took part in this extensive beta program!

We also occasionally post new TestFlight builds on the [Discussion](https://github.com/latenitefilms/BRAWToolbox/discussions) page as we test new features.
We also occasionally post new TestFlight builds on the [Discussion](https://github.com/latenitefilms/BRAWToolbox/discussions){target="_blank"} page as we test new features.

---

### Is BRAW Toolbox Open Source?

Currently the source code for BRAW Toolbox is closed/private, however we may release it under a MIT License at a later date if there's enough demand and interest.

However, if you're looking for an example FxPlug4 codebase, check out [Gyroflow Toolbox](https://github.com/latenitefilms/gyroflowtoolbox/).
However, if you're looking for an example FxPlug4 codebase, check out [Gyroflow Toolbox](https://github.com/latenitefilms/gyroflowtoolbox/){target="_blank"}.

---

### Where can I find some sample BRAW clips?

There are heaps of awesome clips to test with on the Blackmagic Website:

- [Blackmagic Pocket Cinema Camera Gallery](https://www.blackmagicdesign.com/au/products/blackmagicpocketcinemacamera/gallery)
- [Blackmagic URSA Mini Gallery](https://www.blackmagicdesign.com/au/products/blackmagicursaminipro/gallery)
- [Blackmagic Pocket Cinema Camera Gallery](https://www.blackmagicdesign.com/au/products/blackmagicpocketcinemacamera/gallery){target="_blank"}
- [Blackmagic URSA Mini Gallery](https://www.blackmagicdesign.com/au/products/blackmagicursaminipro/gallery){target="_blank"}

---

Expand All @@ -105,28 +105,30 @@ Yes, BRAW Toolbox is compatible with **Sync-N-Link v1.1.4** or later on the Mac

You should use Synchronised Clips in BRAW Toolbox, and it can combine multiple clips with location audio into a multicam.

You can download Sync-N-Link [here](https://apps.apple.com/us/app/sync-n-link-x/id517599985?mt=12){target="_blank"}.

---

### Does BRAW Toolbox work with Lumberjack Builder?

Yes, BRAW Toolbox is compatible with **Lumberjack Builder v4.0.6** or later.

You can download Lumberjack Builder [here](https://www.lumberjacksystem.com/builder-nle-2/).
You can download Lumberjack Builder [here](https://www.lumberjacksystem.com/builder-nle-2/){target="_blank"}.

![](static/builder.png)

---

### I don't like Synchronised Clips. Can I import a Multicam clips instead?

Starting in v1.1.1 of BRAW Toolbox, we now enable **Create Multicam Clips** by default to get around a [Final Cut Pro bug](https://github.com/latenitefilms/BRAWToolbox/issues/128).
Starting in v1.1.1 of BRAW Toolbox, we now enable **Create Multicam Clips** by default to get around a [Final Cut Pro bug](https://github.com/latenitefilms/BRAWToolbox/issues/128){target="_blank"}.

However, we still allow you to disable this, if you need to create Synchronised Clips for Sync-N-Link, for example.

You can click the **Settings** button (the gear icon, next to "Remove All") to select **Create Multicam Clips**.

Please note that this doesn't sync multiple BRAW files together - it just creates a single Multicam Clip for each BRAW file.

You'll still need to use something like [Sync-N-Link](https://apps.apple.com/us/app/sync-n-link-x/id517599985?mt=12) if you want to sync BRAW files with external audio.
You'll still need to use something like [Sync-N-Link](https://apps.apple.com/us/app/sync-n-link-x/id517599985?mt=12){target="_blank"} if you want to sync BRAW files with external audio.

![](static/install-20.png)
8 changes: 4 additions & 4 deletions docs/hdr-workflow.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# HDR Workflow

Thanks to the amazing help of [Marc Bach](https://www.interfacelab.tv) and [Jamie Lejeune](https://www.cinedocs.com), we've worked closely to come up with some solid and reliable HDR Workflow for BRAW Toolbox.
Thanks to the amazing help of [Marc Bach](https://www.interfacelab.tv){target="_blank"} and [Jamie Lejeune](https://www.cinedocs.com){target="_blank"}, we've worked closely to come up with some solid and reliable HDR Workflow for BRAW Toolbox.

In the BRAW Toolbox Workflow Extension, if you click on the **Settings** button (the gear icon, next to **Remove All**), you can select the Color Space:

Expand Down Expand Up @@ -38,6 +38,6 @@ This means you have fantastic grading control directly within Final Cut Pro, and

You can learn more about HDR Workflows in Final Cut Pro here:

- [HDR and Wide Color Gamut in Final Cut Pro White Paper](https://www.apple.com/final-cut-pro/docs/HDR_WideColor.pdf)
- [Intro to wide color gamut and HDR in Final Cut Pro](https://support.apple.com/en-au/guide/final-cut-pro/ver09be4f91f/mac)
- [Convert or adjust HDR clips in Final Cut Pro](https://support.apple.com/en-au/guide/final-cut-pro/verbf72f3e96/mac)
- [HDR and Wide Color Gamut in Final Cut Pro White Paper](https://www.apple.com/final-cut-pro/docs/HDR_WideColor.pdf){target="_blank"}
- [Intro to wide color gamut and HDR in Final Cut Pro](https://support.apple.com/en-au/guide/final-cut-pro/ver09be4f91f/mac){target="_blank"}
- [Convert or adjust HDR clips in Final Cut Pro](https://support.apple.com/en-au/guide/final-cut-pro/verbf72f3e96/mac){target="_blank"}
2 changes: 1 addition & 1 deletion docs/how-to-use.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# How To Use

Once [installed](https://brawtoolbox.io/installation/) you can access BRAW Toolbox from the Workflow Extension button in Final Cut Pro:
Once [installed](/installation) you can access BRAW Toolbox from the Workflow Extension button in Final Cut Pro:

![](static/install-10.png)

Expand Down
4 changes: 2 additions & 2 deletions docs/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@

You can download BRAW Toolbox from the Mac App Store.

> [:icon-desktop-download: **Click here to buy on the Mac App Store**](https://apps.apple.com/au/app/braw-toolbox/id6444061549?mt=12)
> [:icon-desktop-download: **Click here to buy!**](/buy)
![](static/mac-app-store.png)

Expand Down Expand Up @@ -84,4 +84,4 @@ After clicking **OK**, you can now click **Launch Final Cut Pro**, which will cl

> **IMPORTANT:** You should run the BRAW Toolbox application again after each update, to make sure you're using the latest Motion Templates, Metadata View, and LUTs.
You can learn how to use BRAW Toolbox [here](https://brawtoolbox.io/how-to-use/)
You can learn how to use BRAW Toolbox [here](/how-to-use)
Loading

0 comments on commit 51c7e33

Please sign in to comment.