Skip to content

Commit

Permalink
Clean Up
Browse files Browse the repository at this point in the history
- Removed unnecessary `{target="_blank"}` on external links. This is now handled automatically by Retype.
- Tweaked the Disclaimer at top of "How to Use" page.
  • Loading branch information
latenitefilms committed Dec 3, 2023
1 parent 57cca83 commit 84d2257
Show file tree
Hide file tree
Showing 4 changed files with 28 additions and 27 deletions.
10 changes: 5 additions & 5 deletions docs/credits.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,9 @@

Transfer Toolbox has been thrown together by [Chris Hocking](https://github.com/latenitefilms) at [LateNite Films](https://latenitefilms.com).

The Transfer Toolbox icon was designed by [Matthew Skiles](https://matthewskiles.com){target="_blank"}.
The Transfer Toolbox icon was designed by [Matthew Skiles](https://matthewskiles.com).

The Goblins featured in the icon are from LateNite's [Goblin Spoon](https://latenitefilms.com/originals/goblin-spoon/){target="_blank"} series, created by [Nicholas Issell](https://www.imdb.com/name/nm6395828/){target="_blank"}.
The Goblins featured in the icon are from LateNite's [Goblin Spoon](https://latenitefilms.com/originals/goblin-spoon/) series, created by [Nicholas Issell](https://www.imdb.com/name/nm6395828/).

Special thanks to [David Peterson](https://github.com/randomeizer)!

Expand All @@ -14,7 +14,7 @@ Chris also created [CommandPost](https://commandpost.io), [BRAW Toolbox](https:/

## Sparkle

Transfer Toolbox uses [**Sparkle**](https://sparkle-project.org){target="_blank"} for software updates.
Transfer Toolbox uses [**Sparkle**](https://sparkle-project.org) for software updates.

Copyright (c) 2006-2013 Andy Matuschak.
Copyright (c) 2009-2013 Elgato Systems GmbH.
Expand All @@ -35,7 +35,7 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI

### External Licenses

#### [bspatch.c and bsdiff.c, from bsdiff 4.3](http://www.daemonology.net/bsdiff/){target="_blank"}
#### [bspatch.c and bsdiff.c, from bsdiff 4.3](http://www.daemonology.net/bsdiff/)

Copyright 2003-2005 Colin Percival
All rights reserved
Expand All @@ -49,7 +49,7 @@ THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED WAR

---

#### [sais.c and sais.c, from sais-lite (2010/08/07)](https://sites.google.com/site/yuta256/sais){target="_blank"}
#### [sais.c and sais.c, from sais-lite (2010/08/07)](https://sites.google.com/site/yuta256/sais)

The sais-lite copyright is as follows:

Expand Down
2 changes: 1 addition & 1 deletion docs/download.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ You can download **Transfer Toolbox v1.1.0** for free [here](https://github.com/
Please make sure you [read the manual](/how-to-use/), and review the [system requirements](/system-requirements/) before downloading.

!!!primary
If you find Transfer Toolbox useful, consider [buying us a coffee](https://www.buymeacoffee.com/latenitefilms){target="_blank"} or [sponsoring CommandPost](https://commandpost.io/sponsor/){target="_blank"}.
If you find Transfer Toolbox useful, consider [buying us a coffee](https://www.buymeacoffee.com/latenitefilms) or [sponsoring CommandPost](https://commandpost.io/sponsor/).

<a href="https://www.buymeacoffee.com/latenitefilms" target="_blank"><img src="https://img.buymeacoffee.com/button-api/?text=Buy us a coffee &emoji=&slug=latenitefilms&button_colour=5F7FFF&font_colour=ffffff&font_family=Poppins&outline_colour=000000&coffee_colour=FFDD00" /></a>
!!!
Expand Down
39 changes: 20 additions & 19 deletions docs/how-to-use.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,10 +2,11 @@

---

!!!danger Important
!!!danger Disclaimer
Final Cut Pro for iPad is obviously very new, so there are a bunch of **known issues and limitations**.<br />
Please read this **entire page** carefully, and do **workflow tests** before using on a proper job.<br />
We've been using Transfer Toolbox at [LateNite](https://latenitefilms.com){target="_blank"} since it's release, and it's been awesome - but **use at your own risk**.
We've been using Transfer Toolbox at [LateNite](https://latenitefilms.com) since it's release, and it's been awesome - but **use at your own risk**.<br />
Transfer Toolbox is **NOT** recommended or supported by Apple.
!!!

---
Expand Down Expand Up @@ -46,7 +47,7 @@ You'll now find a `.fcpproj` file in the same folder as your `.fcpbundle`:

![](static/result-files.png)

You can now use [Airdrop](https://support.apple.com/en-au/HT203106#:~:text=Select%20AirDrop%20in%20the%20sidebar,recipient%20shown%20in%20the%20window.){target="_blank"}, [iCloud Drive](https://support.apple.com/en-au/guide/mac-help/mchle5a61431/mac){target="_blank"} or other means (such as putting on an external hard drive) to move the project from your Mac to your iPad.
You can now use [Airdrop](https://support.apple.com/en-au/HT203106#:~:text=Select%20AirDrop%20in%20the%20sidebar,recipient%20shown%20in%20the%20window.), [iCloud Drive](https://support.apple.com/en-au/guide/mac-help/mchle5a61431/mac) or other means (such as putting on an external hard drive) to move the project from your Mac to your iPad.

You can now continue editing on **Final Cut Pro (for iPad)**!

Expand All @@ -55,7 +56,7 @@ However, it's **very important** that you read the rest of the **Limitations & K
---

!!!primary
If you find Transfer Toolbox useful, consider [buying us a coffee](https://www.buymeacoffee.com/latenitefilms){target="_blank"} or [sponsoring CommandPost](https://commandpost.io/sponsor/){target="_blank"}.
If you find Transfer Toolbox useful, consider [buying us a coffee](https://www.buymeacoffee.com/latenitefilms) or [sponsoring CommandPost](https://commandpost.io/sponsor/).

<a href="https://www.buymeacoffee.com/latenitefilms" target="_blank"><img src="https://img.buymeacoffee.com/button-api/?text=Buy us a coffee &emoji=&slug=latenitefilms&button_colour=5F7FFF&font_colour=ffffff&font_family=Poppins&outline_colour=000000&coffee_colour=FFDD00" /></a>
!!!
Expand All @@ -66,7 +67,7 @@ If you find Transfer Toolbox useful, consider [buying us a coffee](https://www.b

Serge M has done an awesome video explaining how Transfer Toolbox works on YouTube:

[![](/static/serge-youtube.jpg)](https://www.youtube.com/watch?v=DZdyb2YCRNQ){target="_blank"}
[![](/static/serge-youtube.jpg)](https://www.youtube.com/watch?v=DZdyb2YCRNQ)

---

Expand All @@ -82,9 +83,9 @@ Some very important things to keep in mind:
- All Motion Content and Media should be contained within the Library (i.e. set the Motion Content Storage Location to **In Library** in the Library Inspector on your Mac).
- Your Final Cut Pro (for Mac) timeline/project cannot have any **Stabilisation or Rolling Shutter** effects enabled. If you do, the iPad will just say **Import Failed**.
- Not all Motion Templates will display correctly on the iPad. For example, some Titles using the **Match Move Behaviour** don't appear correctly on Final Cut Pro (for iPad) - the positions are all wrong.
- **FxPlug4** effects (such as [BRAW Toolbox](https://brawtoolbox.io){target="_blank"}) will not work at all on the iPad. Whilst Final Cut Pro (for iPad) does seem to have FxPlug4 Frameworks, there's currently no mechanism for third party to add FxPlug4 to iPad.
- **FxPlug4** effects (such as [BRAW Toolbox](https://brawtoolbox.io)) will not work at all on the iPad. Whilst Final Cut Pro (for iPad) does seem to have FxPlug4 Frameworks, there's currently no mechanism for third party to add FxPlug4 to iPad.
- Final Cut Pro (for iPad) will always **ignore proxy files** - it will always use the Original high-quality media files.
- **Soundtracks** will come across from iPad to Mac. However, they're not "normal" audio clips, and won't appear if you export a FCPXML. This bug has been [reported to Apple](https://github.com/CommandPost/FCPCafe/issues/94){target="_blank"}.
- **Soundtracks** will come across from iPad to Mac. However, they're not "normal" audio clips, and won't appear if you export a FCPXML. This bug has been [reported to Apple](https://github.com/CommandPost/FCPCafe/issues/94).
- Some users have reported that when you AirDrop from Mac to iPad, it can take a few minutes for the project to appear in Final Cut Pro for iPad. We haven't been able to reproduce this on a 12.9inch iPad Pro, so it may be hardware dependant. Basically... be patient if using "older" devices.
- **Compound Clips** will come across correctly, however you cannot modify them in Final Cut Pro for iPad.
- **Multicam Clips** with more than 4 angles will come across correctly, however you still only have access to the first 4 angles in Final Cut Pro for iPad.
Expand All @@ -100,25 +101,25 @@ If you find any other issues or limitations, [please let us know](https://transf
Custom Fonts now appear correctly in **Final Cut Pro (for iPad) v1.1** user interface. Thanks Apple!
!!!

Whilst it's possible to install Custom Fonts on your iPad using an app such as [Fontcase](https://apps.apple.com/au/app/fontcase-manage-your-type/id1205074470){target="_blank"}, and these fonts will appear in apps such as Pages and Numbers, they do **not** appear in the Final Cut Pro (for iPad) Inspector.
Whilst it's possible to install Custom Fonts on your iPad using an app such as [Fontcase](https://apps.apple.com/au/app/fontcase-manage-your-type/id1205074470), and these fonts will appear in apps such as Pages and Numbers, they do **not** appear in the Final Cut Pro (for iPad) Inspector.

You can also install fonts via apps that contain fonts, [via the App Store](https://support.apple.com/en-au/guide/ipad/ipad952422ba/ipados){target="_blank"}, however, these also do **not** appear in the Final Cut Pro (for iPad) Inspector.
You can also install fonts via apps that contain fonts, [via the App Store](https://support.apple.com/en-au/guide/ipad/ipad952422ba/ipados), however, these also do **not** appear in the Final Cut Pro (for iPad) Inspector.

**Final Cut Pro (for iPad) only lists a very strict set of built-in fonts in the Inspector.**

We have submitted a feature request to Apple, as [explained on FCP Cafe](https://github.com/CommandPost/FCPCafe/issues/200){target="_blank"}.
We have submitted a feature request to Apple, as [explained on FCP Cafe](https://github.com/CommandPost/FCPCafe/issues/200).

**However**, if you use the same Custom Font within a Motion Template on Mac, it **will** work on iPad.

For example, the [BBC](https://www.bbc.co.uk){target="_blank"} uses Final Cut Pro for a lot of their programs, so here's the familiar [BBC Reith](https://www.bbc.co.uk/branding/reith-font/){target="_blank"} font in Final Cut Pro for iPad:
For example, the [BBC](https://www.bbc.co.uk) uses Final Cut Pro for a lot of their programs, so here's the familiar [BBC Reith](https://www.bbc.co.uk/branding/reith-font/) font in Final Cut Pro for iPad:

![](../static/bbc-font.jpeg)

!!!warning Please Note:
You may only use BBC Reith if you have an agreement or other authorisation to collaborate with the BBC or BBC Studios. This may be as a broadcasting partner or co-production partner, event promoter, or as a customer of BBC Studios.
!!!

However, even though the above screenshot shows the [BBC Reith](https://www.bbc.co.uk/branding/reith-font/){target="_blank"} font in the Inspector, it **won't** appear if you add another Title within Final Cut Pro (for iPad).
However, even though the above screenshot shows the [BBC Reith](https://www.bbc.co.uk/branding/reith-font/) font in the Inspector, it **won't** appear if you add another Title within Final Cut Pro (for iPad).

You can edit the text though, as normal. Just keep in mind if you change the font to something else, you **can't** change it back.

Expand All @@ -130,19 +131,19 @@ The fact that you can just plug in an external drive into an iPad Pro via USB-C

However, for whatever strange reason, Apple decided not to include an **Eject** button in the **Files** app.

We've now seen cases where if you "pull the plug" on an [macOS Extended or HFS+](https://en.wikipedia.org/wiki/HFS_Plus){target="_blank"} formatted external drive, whilst the iPad is still working on it, it can corrupt the the HFS+ partition.
We've now seen cases where if you "pull the plug" on an [macOS Extended or HFS+](https://en.wikipedia.org/wiki/HFS_Plus) formatted external drive, whilst the iPad is still working on it, it can corrupt the the HFS+ partition.

We haven't seen it happen first hand yet, however we suspect the same issue would happen on [APFS](https://en.wikipedia.org/wiki/Apple_File_System){target="_blank"} formatted drives.
We haven't seen it happen first hand yet, however we suspect the same issue would happen on [APFS](https://en.wikipedia.org/wiki/Apple_File_System) formatted drives.

Once corrupted, the drive no longer appears on iPad.

What's **worse** is that once the external drive is corrupt, as soon as you plug it into an Apple Silicon or Intel Mac, it will just crash the system straight away. An instant and fatal kernel panic.

The only way we've been able to fix the corrupt drives is to use a Windows PC, and use [HFS+ for Windows by Paragon Software](https://www.paragon-software.com/home/hfs-windows/){target="_blank"} to mount and repair the drive.
The only way we've been able to fix the corrupt drives is to use a Windows PC, and use [HFS+ for Windows by Paragon Software](https://www.paragon-software.com/home/hfs-windows/) to mount and repair the drive.

Once repaired on Windows, it works fine again on macOS and iPad.

Given this, it's our **strong recommendation** that if you're using an external drives on iPad, that before you "pull the plug" you "force quit" all applications or better yet, [shutdown the iPad](https://support.apple.com/en-au/guide/ipad/ipad63d30b5a/ipados){target="_blank"} whenever ejecting drives.
Given this, it's our **strong recommendation** that if you're using an external drives on iPad, that before you "pull the plug" you "force quit" all applications or better yet, [shutdown the iPad](https://support.apple.com/en-au/guide/ipad/ipad63d30b5a/ipados) whenever ejecting drives.

You can force quit application on the iPad, by tapping the bottom of the screen and dragging up to the middle, then stopping. This opens the **App Switcher**. You can then swipe up on an app to force quit it.

Expand All @@ -156,7 +157,7 @@ It is possible to store your media on iCloud Drive and effectively "share it" be

When you import media into Final Cut Pro for iPad it will **always** copy to the library.

However, because iPad's use [Apple File System (APFS)](https://support.apple.com/en-au/guide/disk-utility/dsku19ed921c/mac){target="_blank"} for their internal storage, even thought it's **copying** the files from the iCloud drive cache to the Final Cut Pro library, it doesn't actually take up any more "physical" drive space.
However, because iPad's use [Apple File System (APFS)](https://support.apple.com/en-au/guide/disk-utility/dsku19ed921c/mac) for their internal storage, even thought it's **copying** the files from the iCloud drive cache to the Final Cut Pro library, it doesn't actually take up any more "physical" drive space.

When you duplicate a file in APFS, rather than immediately making a complete second copy of the file, the file system essentially just creates a new reference, or pointer, to the existing data. This means that, the duplicate file doesn't take up any extra space because it's just pointing to the same underlying data as the original file.

Expand Down Expand Up @@ -245,12 +246,12 @@ Below is a list of Supported Media in Final Cut Pro for iPad:
- TGA
- TIFF

You can also find this information on [Apple's website](https://support.apple.com/en-au/guide/final-cut-pro-ipad/dev3f1bb94c2/ipados){target="_blank"}.
You can also find this information on [Apple's website](https://support.apple.com/en-au/guide/final-cut-pro-ipad/dev3f1bb94c2/ipados).

---

## Camera Formats

Final Cut Pro for iPad supports a wide range of third-party digital video and still cameras.

You can see the full list on [Apple's website](https://support.apple.com/en-au/HT213668){target="_blank"}.
You can see the full list on [Apple's website](https://support.apple.com/en-au/HT213668).
4 changes: 2 additions & 2 deletions docs/workflow.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,13 +12,13 @@ Final Cut Pro for iPad is perfect for reviewing and doing selects on dailies for

When working in the advertising world, and especially in the corporate advertising world, a lot of agency staff don't have Mac laptops, but own an iPad.

Whilst it's possible to use something like [Frame.io Camera to Cloud](https://frame.io/c2c){target="_blank"} to share proxies straight from camera to your iPad, because of the way it works, the audio channels might be incorrect, which makes relinking a challenge on the Mac end.
Whilst it's possible to use something like [Frame.io Camera to Cloud](https://frame.io/c2c) to share proxies straight from camera to your iPad, because of the way it works, the audio channels might be incorrect, which makes relinking a challenge on the Mac end.

The best option is to get an assistant editor to sync (using something like Sync-N-Link), and organise everything on the Mac.

Once everything is ready to go on the Mac, you can use **Transfer Toolbox** to convert your Final Cut Pro for Mac library into a self-contained Final Cut Pro for iPad project.

You can then send the project to clients/agency/director/mother via email, AirDrop, [PostLab](https://hedge.video/postlab/){target="_blank"}, iCloud Drive, Dropbox, [Digital Pigeon](https://digitalpigeon.com){target="_blank"}, Frame.io, etc.
You can then send the project to clients/agency/director/mother via email, AirDrop, [PostLab](https://hedge.video/postlab/), iCloud Drive, Dropbox, [Digital Pigeon](https://digitalpigeon.com), Frame.io, etc.

They can do their selects on the iPad, and once done, then the project back (without media), where the assistant can then open up on Final Cut Pro 10.7 and consolidate with the master library.

Expand Down

0 comments on commit 84d2257

Please sign in to comment.