Various Improvements

docs/README.md

@@ -2,25 +2,34 @@
 
 # CommandPost
 
-**Workflow Toolkit for Post Production Professionals**
+**The Swiss Army Knife for Post Production Professionals**
 
-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){target="_blank"} macOS application that makes your post production and editing life faster and more fun.
 
-It’s been downloaded over [168 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 adds **hundreds** of features to Apple’s [Final Cut Pro](https://www.apple.com/final-cut-pro/){target="_blank"} to make it even better and more enjoyable to edit with.
 
-It's been used for projects for **Netflix**, **Pixar** and the **BBC**. People at companies such as **Apple** and **Adobe** use it daily.
+It has **extensive** control surface support - allowing you to control your Mac anyway you want.
+
+It's been downloaded over **[168 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 active [Facebook Community](https://www.facebook.com/groups/commandpost/){target="_blank"}.
+
+It's been used for projects at **Netflix**, **Pixar** and the **BBC**. People at companies such as **Apple**, **Avid** and **Adobe** use it daily.
 
 ---
 
 ### Built for Professionals
 
+> “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 I just one click away.”_<br />
+> **[Knut Hake*](http://www.knuthake.de){target="_blank"} (Editor on Netflix's Blood Red Sky)**
+
 > _“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.”_<br />
-> **[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/){target="_blank"} (Assistant Editor on Netflix's Blood Red Sky)**
 
 **Blood & Gold** was cut on Final Cut Pro and made extensive use of CommandPost's [Titles to Keywords Toolbox](https://commandpost.io/toolbox/titles-to-keywords/).
 
 [![](/static/blood-and-gold.jpg)](https://www.youtube.com/watch?v=mqNzrsUerYw){target="_blank"}
 
+We also developed specific features for [Apollo: Missions to the Moon](https://www.imdb.com/title/tt9782756/){target="_blank"}, edited by [David Tillman](https://twitter.com/davidtillman){target="_blank"} and Denmark’s second largest production company, [Metronome Productions](http://www.fcp.co/final-cut-pro/news/867-metronome-celebrate-a-documentary-series-cut-on-fcpx-with-a-birthday-cake){target="_blank"}.
+
 ---
 
 ### Where Technology Meets Creativity

docs/download.md

@@ -1,7 +1,7 @@
 # Download
 
-You can download **CommandPost v1.4.17** [here](https://github.com/CommandPost/CommandPost/releases/download/1.4.17/CommandPost_1.4.17.dmg){target="_blank"}
+You can download the latest **CommandPost v1.4.17** release [here](https://github.com/CommandPost/CommandPost/releases/download/1.4.17/CommandPost_1.4.17.dmg){target="_blank"}.
 
-You can find all previous versions of CommandPost on [GitHub](https://github.com/CommandPost/CommandPost/releases/).
+You can find all previous versions of CommandPost on [GitHub](https://github.com/CommandPost/CommandPost/releases/){target="_blank"}.
 
 You can find installation instructions [here](/installation).

docs/faq.md

@@ -1,12 +1,50 @@
 # Frequently Asked Questions
 
+### Why does CommandPost require "Screen Recording" permissions?
+
+If you're using macOS Catalina or later, CommandPost requires the **Screen Recording** permission to detect things on your screen.
+
+This is a new Security Setting in macOS Catalina, not a change to how CommandPost works.
+
+**CommandPost does not record the screen.**
+
+We're not "recording" the screen as a video like a QuickTime Player or a screen recording application would do - we're simply using Apple's APIs to get access to information about the contents of the screen.
+
+We use Apple's API's to get the name of windows that are open.
+
+We also use the API's to help detect when Final Cut Pro is playing and paused, by "looking" at the play/pause button in the Viewer.
+
+**Nothing is saved to disk. Nothing is transmitted online.**
+
+We simply use Apple's APIs to access screen information.
+
+We also have the option of **OPTIONALLY** sending screenshots when you submit feedback.
+
+Lots of other applications like [Bartender](https://www.macbartender.com/Screen-Recording-Permission/){target="_blank"} and [BetterTouchTool](https://folivora.ai/blog/post/13011/){target="_blank"} have this same limitation.
+
+Also remember, CommandPost is totally open-source, so you can always [inspect the code](https://github.com/CommandPost/CommandPost){target="_blank"} to see what we're doing.
+
+---
+
+### Why did you remove the "Vimeo Toolbox"?
+
+The Vimeo Toolbox has "graduated" from CommandPost and has been spun out into a standalone commercial app called Marker Toolbox.
+
+It's our intention to "spin out" a lot of CommandPost's features into standalone apps with enhancements over the coming years.
+
+However, you can still use Vimeo Toolbox in [older versions of CommandPost](https://github.com/CommandPost/CommandPost/releases){target="_blank"} - no one if forcing you to update CommandPost if you rely on this functionality.
+
+You can learn more about Marker Toolbox [here](https://markertoolbox.io){target="_blank"}.
+
+---
+
 ### Why did you remove "Moveable Markers"?
 
-Moveable Markers was [first discovered](http://alex4d.com/notes/item/fcpx-movable-markers) by Alex Goldner back in June 2014.
+Moveable Markers was [first discovered](http://alex4d.com/notes/item/fcpx-movable-markers){target="_blank"} by **Alex Goldner** back in June 2014.
 
 To enable it, you basically just need to toggle a boolean hidden within a preference file inside the Final Cut Pro Library.
 
-In the early days of [FCPX Hacks](https://latenitefilms.com/blog/fcpx-hacks) we added an option for Moveable Markers which enables them using the same technique Alex found, except it allowed users to easily toggle the feature on and off using the menu bar or shortcut keys.
+In the early days of [FCPX Hacks](https://latenitefilms.com/blog/final-cut-pro-hacks/){target="_blank"} we added an option for Moveable Markers which enables them using the same technique Alex found, except it allowed users to easily toggle the feature on and off using the menu bar or shortcut keys.
 
 When we transitioned FCPX Hacks to CommandPost, we kept this feature, however we've since decided that it's probably a bad idea to modify the contents of the Final Cut Pro application bundle, so we removed this feature all together, along with other features that modify the contents of the Final Cut Pro application bundle (such as inserting our commands into the Final Cut Pro Command Editor).
 
@@ -36,7 +74,7 @@ As CommandPost is just enabling this hidden preference, unfortunately there's no
 
 However, you can still use this feature if you're using Final Cut Pro 10.4.4 to 10.4.8.
 
-If you found this feature useful, please [send feedback to Apple](https://www.apple.com/feedback/finalcutpro.html) explaining how you used it and why you found it useful.
+If you found this feature useful, please [send feedback to Apple](https://www.apple.com/feedback/finalcutpro/){target="_blank"} explaining how you used it and why you found it useful.
 
 ---
 
@@ -48,4 +86,4 @@ As CommandPost is just enabling these hidden preferences, unfortunately there's
 
 However, you can still use these features if you're using Final Cut Pro 10.4.4 to 10.4.8.
 
-If you found this feature useful, please [send feedback to Apple](https://www.apple.com/feedback/finalcutpro.html) explaining how you used it and why you found it useful.
+If you found this feature useful, please [send feedback to Apple](https://www.apple.com/feedback/finalcutpro/){target="_blank"} explaining how you used it and why you found it useful.

docs/final-cut-pro/batch-export-active-timeline.md

@@ -6,11 +6,11 @@ Note that the way CommandPost achieves the batch export is by taking control of
 
 To use Batch Export Active Timeline, first open your timeline and select the clips. Then access the Batch export Active Timeline from the CommandPost Menubar while Final Cut Pro is in focused.
 
-![Batch Export Active Timeline](/static/batch-export-active-timeline-1.png)
+![](../static/batch-export-active-timeline-1.png)
 
 You will be presented with the Batch Export Active Timeline Settings.
 
-![Batch Export Active Timeline Settings](/static/batch-export-active-timeline-2.png)
+![](../static/batch-export-active-timeline-2.png)
 
 This is where you can configure the behaviour of the batch export to:
 
@@ -26,12 +26,12 @@ This is where you can configure the behaviour of the batch export to:
 
 Pressing Perform Batch Export will present you with a final warning before you must let CommandPost take over your computer.
 
-![Batch Export Active Timeline Warning](/static/batch-export-active-timeline-3.png)
+![](../static/batch-export-active-timeline-3.png)
 
 You can still, however, resist CommandPost's control by hiding Final Cut Pro and it will present you with a warning about CommandPost aborting the batch export.
 
-![Batch Export Active Timeline Warning](/static/batch-export-active-timeline-4.png)
+![](../static/batch-export-active-timeline-4.png)
 
 You should be presented with the completion message when all the clips in your selection has been added to the export queue, and you can then resume to use your computer.
 
-![Batch Export Active Timeline Warning](/static/batch-export-active-timeline-5.png)
+![](../static/batch-export-active-timeline-5.png)

docs/final-cut-pro/batch-export-active-timeline.yml

@@ -1,2 +1,3 @@
 label: Batch Export Active Timeline
-icon: device-camera-video
+#icon: device-camera-video
+image: ../static/thumbnail.png

docs/final-cut-pro/hud.yml

@@ -1,2 +1,3 @@
 label: HUD
-icon: device-camera-video
+#icon: device-camera-video
+image: ../static/thumbnail.png

docs/final-cut-pro/local-pasteboard-history.md

@@ -1,3 +1,9 @@
 # Local Pasteboard History
 
-This page is under construction.
+This feature is accessible from the CommandPost Menubar when Final Cut Pro is active:
+
+![](../static/local-pasteboard-history.png)
+
+When enabled, anything you copy in Final Cut Pro will be saved to the Pasteboard History, and recalled later.
+
+You can clear the history from the menubar.

docs/final-cut-pro/local-pasteboard-history.yml

@@ -1,2 +1,3 @@
 label: Local Pasteboard History
-icon: device-camera-video
+#icon: device-camera-video
+image: ../static/thumbnail.png

docs/final-cut-pro/save-browser-contents-to-csv.md

@@ -1,4 +1,17 @@
-# Save Broweser Contnets to CSV
----
+# Save Browser Contents to CSV
 
-This page is under construction.
+This feature allows you to save the entire text contents of your Final Cut Pro **Browser** to a CSV file.
+
+You can access the **Save Browser Contents to CSV** function from the CommandPost Menubar:
+
+![](../static/save-browser-contents-to-csv-menubar.png)
+
+You can also access it from the **Search Console**:
+
+![](../static/save-browser-contents-to-csv-search-console.png)
+
+When you trigger the action, it will ask you for a **folder** to save the CSV to.
+
+You can then open the CSV in something like Apple's Numbers:
+
+![](../static/homepage-csv.png)

docs/final-cut-pro/save-browser-contents-to-csv.yml

@@ -1,2 +1,3 @@
 label: Save Browser Contents to CSV
-icon: device-camera-video
+#icon: device-camera-video
+image: ../static/thumbnail.png

docs/final-cut-pro/save-timeline-index-to-csv.md

@@ -1,3 +1,21 @@
 # Save Timeline Index to CSV
 
-This page is under construction.
+This feature allows you to save the entire text contents of your **Timeline Index** to a CSV file.
+
+You can access the **Save Timeline Index to CSV** function from the CommandPost Menubar:
+
+![](../static/save-timeline-index-to-csv-menubar.png)
+
+You can also access it from the **Search Console**:
+
+![](../static/save-timeline-index-to-csv-search-console.png)
+
+When you trigger the action, it will ask you for a **folder** to save the CSV to.
+
+You can then open the CSV in something like Apple's Numbers:
+
+![](../static/timeline-index-csv.png)
+
+
+
+

docs/final-cut-pro/save-timeline-index-to-csv.yml

@@ -1,2 +1,3 @@
 label: Save Timeline Index to CSV
-icon: device-camera-video
+#icon: device-camera-video
+image: ../static/thumbnail.png

docs/final-cut-pro/scrolling-timeline.yml

@@ -1,2 +1,3 @@
 label: Scrolling Timeline
-icon: device-camera-video
+#icon: device-camera-video
+image: ../static/thumbnail.png

docs/final-cut-pro/shared-pasteboard-history.md

@@ -1,15 +1,23 @@
 # Shared Pasteboard
 
-Shared Pasteboard is another tools that is only available when used with Final Cut. It allows you to share reference to anything that you can natively copy and paste in Final Cut. This includes clips, generators, titles, etc. Multiple clips can be copied at once, and any effects and settings applied will also be copied along. For this to work properly, the other machines should have the media assets already in the library, otherwise a placeholder with the names and attributes will be pasted instead.
+Shared Pasteboard is another tools that is only available when used with Final Cut Pro.
 
-![Enable Shared Pasteboard](/static/enable-shared-pasteboard.png)
+It allows you to share reference to anything that you can natively copy and paste in Final Cut.
 
-This feature is off by default and must be activated by going to the "Shared Pasteboard History" dropdown menu from the CommandPost menu, and clicking "Enable Shared Pasteboard".
+This includes clips, generators, titles, etc. Multiple clips can be copied at once, and any effects and settings applied will also be copied along.
 
-When you click "Enable Shared Pasteboard" you will be prompted to select a folder in which you’ll save your shared pasteboard.
+For this to work properly, the other machines should have the media assets already in the library, otherwise a placeholder with the names and attributes will be pasted instead.
+
+![](../static/enable-shared-pasteboard.png)
+
+This feature is off by default and must be activated by going to the **Shared Pasteboard History** dropdown menu from the CommandPost menu when Final Cut Pro is active, and clicking **Enable Shared Pasteboard**.
+
+When you click **Enable Shared Pasteboard** you will be prompted to select a folder in which you’ll save your shared pasteboard.
 
 This should be a network drive, or cloud storage such as iCloud or Dropbox, so multiple editors can access the shared pasteboard at the same time.
 
-Once enabled, when you copy clips in the Browser or Timeline within Final Cut Pro, it will automatically appear on the "Shared Pasteboard History" drop down from the CommandPost menu on all of your machines that are running CommandPost and pointing to the same Shared Clipboard folder. Clicking the option representing the copied clips will paste the clip on your opened timeline.
+Once enabled, when you copy clips in the Browser or Timeline within Final Cut Pro, it will automatically appear on the **Shared Pasteboard History** drop down from the CommandPost menu on all of your machines that are running CommandPost and pointing to the same Shared Clipboard folder.
+
+Clicking the option representing the copied clips will paste the clip on your opened timeline.
 
 This makes sharing edit versions between machines as easy as copying and pasting!

docs/final-cut-pro/shared-pasteboard-history.yml

@@ -1,2 +1,3 @@
 label: Shared Pasteboard History
-icon: device-camera-video
+#icon: device-camera-video
+image: ../static/thumbnail.png

docs/final-cut-pro/viewer-overlay.md

@@ -1,3 +1,20 @@
 # Viewer Overlay
 
-This page is under construction.
+The Viewer Overlay feature allows you to add overlays on top of Final Cut Pro's Viewer.
+
+You can access the controls from the CommandPost menubar item when Final Cut Pro is active:
+
+![](../static/viewer-overlay.png)
+
+If you click **Enable Viewer Contextual Menu** you can also access it by right-clicking on the Final Cut Pro Viewer toolbox:
+
+![](../static/viewer-overlay-contextual.png)
+
+There's also the option to **Toggle Overlay's with Caps Lock**.
+
+It's extremely customisable and flexible, and a good compliment to Final Cut Pro's own **Custom Overlay** features.
+
+![](../static/viewer-overlay-controls.png)
+
+
+

docs/final-cut-pro/viewer-overlay.yml

@@ -1,2 +1,3 @@
 label: Viewer Overlay
-icon: device-camera-video
+#icon: device-camera-video
+image: ../static/thumbnail.png

docs/interface/debug-console.yml

@@ -1,2 +1,3 @@
 label: Debug Console
-icon: browser
+#icon: browser
+image: ../static/thumbnail.png

docs/interface/menubar.yml

@@ -1,2 +1,3 @@
 label: Menubar
-icon: browser
+#icon: browser
+image: ../static/thumbnail.png

docs/interface/prevent-mac-from-sleeping.yml

@@ -1,2 +1,3 @@
 label: Prevent Mac from Sleeping
-icon: browser
+#icon: browser
+image: ../static/thumbnail.png

docs/interface/search-console.yml

@@ -1,2 +1,3 @@
 label: Search Console
-icon: browser
+#icon: browser
+image: ../static/thumbnail.png

docs/interface/sending-apple-feedback.yml

@@ -1,2 +1,3 @@
 label: Sending Apple Feedback
-icon: browser
+#icon: browser
+image: ../static/thumbnail.png