Skip to content
Back to search

TitleCut

Native macOS editor for short social videos: timed titles, auto-captions, silence removal, and an MCP server for Claude Code.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/drbenedictporkins--titlecut/badge.svg)](/listings/drbenedictporkins--titlecut)

HTML

<a href="/listings/drbenedictporkins--titlecut"><img src="/api/listings/drbenedictporkins--titlecut/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

TitleCut runs an MCP server over HTTP on `127.0.0.1`, default port 7340. Every edit made through MCP appears in the open window and is one undo step.

1. Start TitleCut. 2. Click the MCP button in the top bar. This starts the server and opens a panel. 3. Copy the command under "Claude Code setup" and run it once in a terminal. It has this form:

   claude mcp add --transport http titlecut http://127.0.0.1:7340/mcp

4. Start a new Claude Code session.

The panel can require a key. When it is on, the setup command includes an `Authorization: Bearer` header, and calls without the key are refused. When the key changes, or key use is turned on or off, run `claude mcp remove titlecut` and the new command.

The server listens on the local machine only.

Tools

Call `get_instructions` first. It returns the full manual. Tools include:

- Session: `list_projects`, `get_project`, `new_project`, `undo`, `redo`, `save` - Video: `open_video`, `add_video`, `set_shape`, `seek`, `play`, `pause` - Clips: `split_at`, `trim_segment`, `move_segment`, `set_clip`, `set_framing`, `set_split`, `frame_faces` - Stills: `freeze_frame`, `set_camera`, `insert_card`, `set_transition` - Titles: `list_styles`, `add_title`, `update_title`, `set_titles_style` - Captions: `auto_captions`, `get_transcript`, `export_subtitles` - Cuts: `find_silences`, `remove_silences`, `find_fillers`, `remove_fillers` - Music: `add_music`, `update_music` - Output: `render_frame`, `export`, `job_status`

`auto_captions` and `export` return at once. Poll `job_status` for the result.

Folders permission

TitleCut is sandboxed. macOS lets a sandboxed app open a file only after the person has chosen it, in an Open panel or by dragging it in. A path sent over MCP is not a choice.

The MCP panel has a Folders section. Adding a folder chooses everything in it at once. Claude can then open videos and songs from that folder and save exports to it. The Movies and Music folders are allowed from the start. Files opened by hand work from any folder.

`open_video`, `add_video`, `add_music`, `export` and `export_subtitles` take absolute paths inside these folders.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 170 lines
  1. # TitleCut
  2. A native macOS app that adds timed titles, captions, freeze frames and camera moves to a video and exports it to MP4 or GIF.
  3. ## Demo
  4. [docs/demo.mp4](docs/demo.mp4) (35 s): one request typed into Claude Code, then Claude driving TitleCut over MCP. It cuts the pauses, adds captions, frames the speaker's face for 9:16, adds a title and music, and exports. The run took 1 min 45 s with no hand edits; the video shows it at 6x speed.
  5. [docs/result-short.mp4](docs/result-short.mp4) (21.6 s, 720 x 1280): the finished vertical short from that run.
  6. Footage: NASA, "Connecting Classrooms to Space: Ham Radio Explainer". NASA does not endorse this project.
  7. ## Screenshots
  8. ![Editor: preview, timeline and inspector](docs/screenshots/editor.png)
  9. ![Remove Silences sheet with live preview](docs/screenshots/remove-silences.png)
  10. ![Export sheet with size options and file-size estimates](docs/screenshots/export.png)
  11. ![MCP panel showing the Claude Code setup command and server address](docs/screenshots/mcp.png)
  12. ## Features
  13. **Titles**
  14. - Timed text titles with a style library (Dark Box, Bold Shadow, Subtitle, Serif, Neon, Meme and others).
  15. - In and out motions: none, fade, slide, scale, typewriter.
  16. - Per-title font, weight, colour, outline, box, shadow, alignment and position.
  17. **Captions**
  18. - Auto-captions from on-device speech recognition. No cloud service is used.
  19. - Word highlight in captions.
  20. - Export of captions as an `.srt` file, saved beside the MP4.
  21. **Cutting**
  22. - Remove Silences with a live preview. Settings: quieter-than threshold, longer-than duration and shortest kept clip. Shift-drag the strip to limit the work to a range. All cuts apply as one undo step.
  23. - Remove Filler Words (um, uh, er, ah, hmm), based on the transcript.
  24. - Split, trim and move clips. Add more videos to the timeline.
  25. - Clip speed 0.5x to 10x, with pitch preserved for speech. Clip volume 0 to 2.
  26. **Stills and cards**
  27. - Freeze frames with a set length.
  28. - Still images dropped onto the timeline.
  29. - Camera moves on stills (Ken Burns): start from the whole frame, move to a chosen centre and zoom, hold, with a choice of pace.
  30. - Title cards: solid colour segments for titles.
  31. **Transitions**
  32. - Dip to black, dip to white and crossfade at cuts. Dips also work at the start and end of the video.
  33. - Length 0.1 s to 5 s. A transition never changes the video length.
  34. **Framing**
  35. - Output shapes: 16:9, 9:16, 1:1 and Original.
  36. - Per-clip framing: position and zoom (1x to 6x).
  37. - Face framing: centres the largest face in each clip and splits the clip where the face moves.
  38. - Split screen: two framed halves of one clip, stacked or side by side depending on the shape.
  39. **Audio**
  40. - Background music strip with start, trim, volume and fade in and out per piece.
  41. - Screen recording (Record Screen), added to the timeline.
  42. **Export**
  43. - MP4 with H.264 or HEVC.
  44. - Sizes: Original, Large (1920 px longest side), Medium (1280 px), Small (960 px). The scaled sizes cap the frame rate at 30 fps. The export sheet shows an estimated file size.
  45. - Animated GIF: width 320, 480 or 720 px, 10, 15 or 24 fps, loop or play once. Also shows an estimated size.
  46. **MCP server**
  47. - An MCP server built into the app lets Claude Code drive the running window. See [Claude Code / MCP setup](#claude-code--mcp-setup).
  48. ## Requirements
  49. - macOS 26.0 or later.
  50. - Xcode 26 or later with Swift 6 (strict concurrency is on).
  51. - [XcodeGen](https://github.com/yonaskolb/XcodeGen).
  52. Package dependency, fetched by Xcode: [MCP Swift SDK](https://github.com/modelcontextprotocol/swift-sdk) 0.12.1.
  53. ## Build
  54. The `.xcodeproj` is generated from `project.yml` and is not committed.
  55. ```sh
  56. brew install xcodegen
  57. xcodegen generate
  58. open TitleCut.xcodeproj
  59. ```
  60. Command line:
  61. ```sh
  62. xcodebuild -project TitleCut.xcodeproj -scheme TitleCut -configuration Release build
  63. ```
  64. The Debug configuration is signed with a specific development certificate and team in `project.yml`. To build Debug on another machine, change `CODE_SIGN_IDENTITY` and `DEVELOPMENT_TEAM` under `settings.configs.Debug`, or build Release, which is ad-hoc signed.
  65. The app is sandboxed. See `App/TitleCut.entitlements`.
  66. ## Tests
  67. ```sh
  68. xcodegen generate
  69. xcodebuild test -project TitleCut.xcodeproj -scheme TitleCut -destination 'platform=macOS'
  70. ```
  71. The `CoreTests` target covers the model, timeline math, rendering, export sizes and project commands.
  72. ## Claude Code / MCP setup
  73. TitleCut runs an MCP server over HTTP on `127.0.0.1`, default port 7340. Every edit made through MCP appears in the open window and is one undo step.
  74. 1. Start TitleCut.
  75. 2. Click the MCP button in the top bar. This starts the server and opens a panel.
  76. 3. Copy the command under "Claude Code setup" and run it once in a terminal. It has this form:
  77. ```sh
  78. claude mcp add --transport http titlecut http://127.0.0.1:7340/mcp
  79. ```
  80. 4. Start a new Claude Code session.
  81. The panel can require a key. When it is on, the setup command includes an `Authorization: Bearer` header, and calls without the key are refused. When the key changes, or key use is turned on or off, run `claude mcp remove titlecut` and the new command.
  82. The server listens on the local machine only.
  83. ### Tools
  84. Call `get_instructions` first. It returns the full manual. Tools include:
  85. - Session: `list_projects`, `get_project`, `new_project`, `undo`, `redo`, `save`
  86. - Video: `open_video`, `add_video`, `set_shape`, `seek`, `play`, `pause`
  87. - Clips: `split_at`, `trim_segment`, `move_segment`, `set_clip`, `set_framing`, `set_split`, `frame_faces`
  88. - Stills: `freeze_frame`, `set_camera`, `insert_card`, `set_transition`
  89. - Titles: `list_styles`, `add_title`, `update_title`, `set_titles_style`
  90. - Captions: `auto_captions`, `get_transcript`, `export_subtitles`
  91. - Cuts: `find_silences`, `remove_silences`, `find_fillers`, `remove_fillers`
  92. - Music: `add_music`, `update_music`
  93. - Output: `render_frame`, `export`, `job_status`
  94. `auto_captions` and `export` return at once. Poll `job_status` for the result.
  95. ### Folders permission
  96. TitleCut is sandboxed. macOS lets a sandboxed app open a file only after the person has chosen it, in an Open panel or by dragging it in. A path sent over MCP is not a choice.
  97. The MCP panel has a Folders section. Adding a folder chooses everything in it at once. Claude can then open videos and songs from that folder and save exports to it. The Movies and Music folders are allowed from the start. Files opened by hand work from any folder.
  98. `open_video`, `add_video`, `add_music`, `export` and `export_subtitles` take absolute paths inside these folders.
  99. ## Project layout
  100. - `App/` - application target: windows, top bar, MCP server (`App/MCP`), screen recording, MCP panel.
  101. - `Core/` - `TitleCutCore` framework: project model, timeline, composition, rendering, captions, framing, export, persistence.
  102. - `UI/` - SwiftUI and AppKit views: timeline, preview, inspector, silences, captions, stills, export.
  103. - `Tests/` - unit tests (`CoreTests`) and fixtures.
  104. - `DemoKit/` - demo media and a walkthrough that exercises every feature by hand and over MCP (`DemoKit/README.qmd`).
  105. - `StoreKit/` - StoreKit configuration file used for local purchase testing from Xcode.
  106. - `project.yml` - XcodeGen project definition.
  107. - `PLAN.qmd` - design plan.
  108. ## License
  109. MIT. See [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.