Transfer Toolbox 1.1.0 (4)
+ +π¨ Improvements
+-
+
- Transfer Toolbox is now compatible with Final Cut Pro 10.7 and Final Cut Pro 1.3 (for iPad). +
- Updated Sparkle from v2.4.1 to v2.5.1. +
Transfer Toolbox 1.0.2 (3)
diff --git a/docs/appcast.xml b/docs/appcast.xml index 8ab4258..93324c0 100644 --- a/docs/appcast.xml +++ b/docs/appcast.xml @@ -2,6 +2,15 @@
+!!!
\ No newline at end of file
diff --git a/docs/download.yml b/docs/download.yml
new file mode 100644
index 0000000..58d1ad4
--- /dev/null
+++ b/docs/download.yml
@@ -0,0 +1,4 @@
+label: Download
+icon: desktop-download
+order: 9000
+image: /static/thumbnail.jpg
\ No newline at end of file
diff --git a/docs/how-to-use.md b/docs/how-to-use.md
new file mode 100644
index 0000000..92f9f5c
--- /dev/null
+++ b/docs/how-to-use.md
@@ -0,0 +1,256 @@
+# How To Use
+
+---
+
+!!!danger Important
+Final Cut Pro for iPad is obviously very new, so there are a bunch of **known issues and limitations**.+Please read this **entire page** carefully, and do **workflow tests** before using on a proper job.
+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**. +!!! + +--- + +## Introduction + +Your **Final Cut Pro (for Mac) Library** should contain a **single Event** with the following naming convention: + +> **Default MM-DD-YY** + +For example: + +> **Default 05-31-23** + +You can handle multiple projects in that single Event, but their start timecode should all be **00:00:00:00**. + +Then, simply drag-and-drop your **Final Cut Pro (for Mac) library** onto the Library icon drop zone, or click the **Convert Library** button to manually select a **Final Cut Pro (for Mac) library**: + + + +If you drag in a **Final Cut Pro (for Mac) Library** with multiple Events, you'll be presented with this warning: + + + +If you drag in a **Final Cut Pro (for Mac) Library** with the wrong Event naming convention, you'll be presented with this warning: + + + +If you've dragged in a valid **Final Cut Pro (for Mac) Library**, or you clicked **OK** to either of the above warnings, you will be presented with a Open Panel to **Grant Access** to that Library: + + + +After clicking **Grant Access**, you'll be presented with a success message: + + + +You'll now find a `.fcpproj` file in the same folder as your `.fcpbundle`: + + + +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 continue editing on **Final Cut Pro (for iPad)**! + +However, it's **very important** that you read the rest of the **Limitations & Known Issues** below, so that you're aware of things that don't translate properly between Mac and iPad. + +--- + +!!!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"}. + +
+!!!
+
+---
+
+## Video Tutorial
+
+Serge M has done an awesome video explaining how Transfer Toolbox works on YouTube:
+
+[](https://www.youtube.com/watch?v=DZdyb2YCRNQ){target="_blank"}
+
+---
+
+## Limitations & Known Issues
+
+Some very important things to keep in mind:
+
+- Transfer Toolbox requires **Final Cut Pro 10.7** and **Final Cut Pro 1.3 (for iPad)**.
+- You should ensure your library only has a **single event** with the following naming convention: **Default MM-DD-YY** (i.e **Default 05-31-23**).
+- Transfer Toolbox will warn you if it detects more than one event, or if you don't use the above event naming convention, but it still allows you to proceed.
+- If you use a different event name, you may not see anything in your browser on the iPad.
+- All project timecode should start at **00:00:00:00**. I **assume** this is because there's currently no way in Final Cut Pro (for iPad) to customise the start timecode of a timeline.
+- 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.
+- 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"}.
+- 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.
+- The **Flow** transition does work correctly between Mac and iPad, however, interestingly, the rendering results can be visually different between platforms. Mac seems better quality than iPad.
+
+If you find any other issues or limitations, [please let us know](https://transfertoolbox.io/support/).
+
+---
+
+## Custom Fonts
+
+!!!success Update!
+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.
+
+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.
+
+**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"}.
+
+**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:
+
+
+
+!!!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).
+
+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.
+
+---
+
+## Danger using External Drives on iPad
+
+The fact that you can just plug in an external drive into an iPad Pro via USB-C is awesome and amazing!
+
+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 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.
+
+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.
+
+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.
+
+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.
+
+If you're external drive has an LED status light, that's another good way to determine if the iPad is still doing "stuff" with it.
+
+---
+
+## Storing Media on iCloud
+
+It is possible to store your media on iCloud Drive and effectively "share it" between your Mac and your iPad.
+
+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.
+
+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.
+
+When sending your project from Final Cut Pro on iPad back to your Mac, just export with the **Include All Media** option disabled, and then manually relink to your iCloud Drive files within Final Cut Pro on Mac.
+
+---
+
+## Storing Media Externally
+
+!!!danger Important
+Unfortunately, whilst this worked on **Final Cut Pro v1.0.0**, Apple has removed support for this workflow in **Final Cut Pro v1.0.1**.+
+We are still testing and exploring other possibilities and workarounds for "linking to" external media. +!!! + +Interestingly, it is actually possible to "link" to media on an external hard drive. + +However, even though Final Cut Pro (for iPad) will "link" to the external drive initially, and when you first start editing, you'll be editing off the external drive - in the background, Final Cut Pro will start copying everything across to the internal drive. + +As far as we can tell, there's currently no way to stop Final Cut Pro from importing the footage to your iPad's internal drive. + +This works slightly differently to DaVinci Resolve (for iPad) and LumaFusion, which both support "linking" to external drives without having a local/internal copy. + +With that in mind, if you still want to "link" to your media initially, you'll need to create the Final Cut Pro library on macOS, and make sure you keep the media **external** to the library. + +As long as both the generated Final Cut Pro (for iPad) project and media are on the same external hard drive, in the same location as they were on the Mac, everything will work. + +The reason for this is that internally Final Cut Pro (for Mac) created document-scope security-scoped bookmarks to each media file, which Final Cut Pro (for iPad) can also use to get access to the files, even in a sandboxed environment. + +After creating a new Final Cut Pro (for iPad) project using Transfer Toolbox, you may need to open the library back up on the Mac, to update all the bookmarks. + +Simply right-click on the new Final Cut Pro (for iPad) project in Finder and select **Show Package Contents**. + + + +Within the package contents, two folders deep, you'll find the Final Cut Pro (for Mac) library that you can now open on your Mac. + + + +Once you open it, and allow Background Tasks to complete, you can then close it, as the document-scope security-scoped bookmarks should now be updated. + +We will investigate automating this process in a future update. + +You can then import Final Cut Pro (for iPad) libraries via the home screen: + + + +Just select the project on your external drive: + + + +--- + +## Supported Media + +Below is a list of Supported Media in Final Cut Pro for iPad: + +### Video Formats + +- Apple ProRes +- Apple ProRes RAW and Apple ProRes RAW HQ +- H.264 +- HEVC +- MXF (Apple ProRes) + +### Audio Formats + +- AAC +- AIFF +- BWF +- CAF +- MP3 +- MP4 +- WAV + +### Stills Formats + +- Apple ProRAW +- BMP +- GIF +- HEIF +- JPEG +- PNG +- PSD +- RAW +- 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"}. + +--- + +## 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"}. \ No newline at end of file diff --git a/docs/how-to-use.yml b/docs/how-to-use.yml new file mode 100644 index 0000000..f1c17ff --- /dev/null +++ b/docs/how-to-use.yml @@ -0,0 +1,4 @@ +label: How To Use +icon: flame +order: 7900 +image: /static/thumbnail.jpg \ No newline at end of file diff --git a/docs/latenite-technology.md b/docs/latenite-technology.md new file mode 100644 index 0000000..10dc32c --- /dev/null +++ b/docs/latenite-technology.md @@ -0,0 +1,7 @@ +# Explore LateNite's Tools + +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. + +You can learn more about LateNite's tools such as CommandPost, BRAW Toolbox, Gyroflow Toolbox, Marker Toolbox, Recall Toolbox and Fast Collections over at [FCP Cafe](https://fcp.cafe). \ No newline at end of file diff --git a/docs/latenite-technology.yml b/docs/latenite-technology.yml new file mode 100644 index 0000000..ab45b11 --- /dev/null +++ b/docs/latenite-technology.yml @@ -0,0 +1,4 @@ +label: Explore LateNite's Tools! +icon: zap +order: 8900 +image: /static/thumbnail.jpg \ No newline at end of file diff --git a/docs/privacy.md b/docs/privacy.md new file mode 100644 index 0000000..0fc8569 --- /dev/null +++ b/docs/privacy.md @@ -0,0 +1,19 @@ +# Privacy Policy + +This is the privacy policy for the Transfer Toolbox, macOS Application that is available on TestFlight and for free via GitHub. + +Transfer Toolbox does not collect any user data. No personal information is transmitted, stored, or used by this application. + +Transfer Toolbox does not use any third-party analytics or tracking tools. It does not contain any in-app purchases or advertisements. + +Transfer Toolbox does not communicate with any external servers or services, and it does not access any data on your device beyond what is necessary for the application to function properly. + +Apple may collect and use certain usage and performance data from the apps that are available on TestFlight. 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/). + +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/transfertoolbox/issues), or email us: support@latenitefilms.com \ No newline at end of file diff --git a/docs/privacy.yml b/docs/privacy.yml new file mode 100644 index 0000000..c7af074 --- /dev/null +++ b/docs/privacy.yml @@ -0,0 +1,4 @@ +label: Privacy Policy +icon: info +order: 2 +image: /static/thumbnail.jpg \ No newline at end of file diff --git a/docs/release-notes.md b/docs/release-notes.md new file mode 100644 index 0000000..35e25cb --- /dev/null +++ b/docs/release-notes.md @@ -0,0 +1,40 @@ +# Release Notes + +### 1.1.0 + +**π Released:** +- 3rd December 2023 + +**π¨ Improvements:** +- Transfer Toolbox is now compatible with Final Cut Pro 10.7 and Final Cut Pro 1.3 (for iPad). +- Updated Sparkle from v2.4.1 to v2.5.1. + +--- + +### 1.0.2 + +**π Released:** +- 18th June 2023 + +**π Changes:** +- Transfer Toolbox will no longer be distributed on the Apple App Store or TestFlight, and instead will be a free download. + +--- + +### 1.0.1 + +**π Released:** +- 26th May 2023 + +**π Changes:** +- Changed the App Store Subtitle. + +--- + +### 1.0.0 + +**π Released:** +- 26th May 2023 + +**Woohoo! π** +- This is the first release of Transfer Toolbox on Apple's TestFlight. \ No newline at end of file diff --git a/docs/release-notes.yml b/docs/release-notes.yml new file mode 100644 index 0000000..05c3924 --- /dev/null +++ b/docs/release-notes.yml @@ -0,0 +1,4 @@ +label: Release Notes +icon: versions +order: 5000 +image: /static/thumbnail.jpg \ No newline at end of file diff --git a/docs/retype.yml b/docs/retype.yml index 5482eb9..0611b04 100644 --- a/docs/retype.yml +++ b/docs/retype.yml @@ -9,6 +9,20 @@ branding: links: +- text: Download + link: /download/ + icon: desktop-download + +- text: Issues + link: https://github.com/latenitefilms/transfertoolbox/issues + icon: issue-opened + target: blank + +- text: Discussions + link: https://github.com/latenitefilms/transfertoolbox/discussions + icon: comment-discussion + target: blank + - text: FCP Cafe link: https://fcp.cafe icon: flame @@ -20,7 +34,7 @@ links: target: blank - text: LateNite - link: https://latenitefilms.com/technology/ + link: /latenite-technology/ icon: light-bulb footer: diff --git a/docs/support.md b/docs/support.md new file mode 100644 index 0000000..0af3d73 --- /dev/null +++ b/docs/support.md @@ -0,0 +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/transfertoolbox/issues). + +If you have any general questions or feedback, you can discuss [here](https://github.com/latenitefilms/transfertoolbox/discussions). + +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=Transfer%20Toolbox%20Support) + +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/support.yml b/docs/support.yml new file mode 100644 index 0000000..76356a7 --- /dev/null +++ b/docs/support.yml @@ -0,0 +1,4 @@ +label: Support +icon: bug +order: 7500 +image: /static/thumbnail.jpg \ No newline at end of file diff --git a/docs/system-requirements.md b/docs/system-requirements.md new file mode 100644 index 0000000..c0fe1d0 --- /dev/null +++ b/docs/system-requirements.md @@ -0,0 +1,5 @@ +# System Requirements + +Transfer Toolbox requires **Final Cut Pro 10.7** and **Final Cut Pro 1.3 (for iPad)**. + +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 diff --git a/docs/system-requirements.yml b/docs/system-requirements.yml new file mode 100644 index 0000000..86d95e1 --- /dev/null +++ b/docs/system-requirements.yml @@ -0,0 +1,4 @@ +label: System Requirements +icon: gear +order: 8998 +image: /static/thumbnail.jpg \ No newline at end of file diff --git a/docs/uninstall.md b/docs/uninstall.md new file mode 100644 index 0000000..39f7802 --- /dev/null +++ b/docs/uninstall.md @@ -0,0 +1,3 @@ +# Uninstall + +To uninstall Transfer Toolbox, simply drag the application to the trash/bin. \ No newline at end of file diff --git a/docs/uninstall.yml b/docs/uninstall.yml new file mode 100644 index 0000000..ca44d16 --- /dev/null +++ b/docs/uninstall.yml @@ -0,0 +1,4 @@ +label: Uninstall +icon: trash +order: 4900 +image: /static/thumbnail.jpg \ No newline at end of file diff --git a/docs/workflow.md b/docs/workflow.md new file mode 100644 index 0000000..55f0703 --- /dev/null +++ b/docs/workflow.md @@ -0,0 +1,27 @@ +# Workflow + +Why exactly would you want to move from a Mac to an iPad for Final Cut Pro? + +This page offers some workflow ideas and suggestions. + +--- + +### Dailies + +Final Cut Pro for iPad is perfect for reviewing and doing selects on dailies for all levels of projects, from short films to Hollywood Feature Films. + +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. + +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. + +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. + +Because of it's touch interface and Apple Pencil support, the iPad is the perfect rushes review platform - as it's fast and fun. + +Directors can also experiment with edits on Final Cut Pro for iPad - and everything will transfer perfectly back to the Mac. \ No newline at end of file diff --git a/docs/workflow.yml b/docs/workflow.yml new file mode 100644 index 0000000..f29fff0 --- /dev/null +++ b/docs/workflow.yml @@ -0,0 +1,4 @@ +label: Workflows +icon: device-camera-video +order: 7899 +image: /static/thumbnail.jpg \ No newline at end of file