Connectors link ChatCut to accounts you already use. Use Google Drive or Dropbox to bring media into a project, YouTube to upload an export to your channel, and X to publish a post.
Which connectors can I use?
- Dropbox and X, in ChatCut Desktop 0.9.1 or later and in the web app.
- Google Drive and YouTube appear in ChatCut Desktop 0.9.17 or later and in ChatCut Web. Use them in the project editor or its Agent chat. The hosted Agent Plugin offers Dropbox and X only.
- You must be signed in to ChatCut. Connecting needs your ChatCut account first.
How do I connect an account?
Connect from the chat box of a project:
- Open a project and its Agent chat.
- Click + in the chat box and choose Connector.
- Click Connect next to the service. Your browser opens the provider’s own sign-in and consent page. On the web, allow the pop-up if your browser blocks it.
- Approve access there. Back in ChatCut, the row’s button changes to Details.
You can also open Connectors in the home sidebar on the web or in Desktop 0.9.17 or later. If the connection action is unavailable, check again before starting an import or upload.
You can also ask the Agent, for example “Connect my X account.” It shows a Connect X button in the chat. Only your click starts the sign-in, and you sign in on X’s page yourself. The Agent cannot sign in or approve access for you. Once you are connected, it continues the task in the same chat.
If the sign-in times out or you cancel, click Connect again. If an account’s access expired, its row shows Reconnect. Connecting is not permission to post or upload anything. It only links the account.
What can ChatCut read from my accounts?
- Dropbox: read-only. ChatCut asks to read your account info, file names and file contents so it can list and download media you choose. It cannot edit or delete your Dropbox files.
- X: ChatCut asks to read your posts and profile and to create posts and upload media for them. It uses these to publish a post you approve and to read statistics for your own posts.
- Google Drive: Google Picker grants access to the files you select. ChatCut can download those files for the project.
- YouTube: ChatCut identifies your channel, uploads approved videos and reads the processing status and statistics of your own videos.
- ChatCut does not show you or the Agent your sign-in credentials.
How do I bring Dropbox media into a project?
- Click + in the chat box, choose Connector, then Dropbox.
- Search by file name or browse the list. ChatCut lists audio, video, images, GIFs and SVGs.
- Select files and click Add to chat. You can add up to 20 files at a time.
Choosing a file attaches a reference to it. ChatCut downloads the original into your project only when the task needs the whole file, for example to read, transcribe or edit it. A reference alone is enough for the Agent to name the file or look at its thumbnail.
Attaching is not the same as importing:
- Attached reference: a pointer to the Dropbox file at the version you selected. Nothing is copied yet.
- Imported media: the original file is downloaded into the project’s Media Pool and can go on the timeline. The Agent does this for you when the task needs it. Transcription is skipped unless you ask for it.
- ChatCut never silently switches to a newer version of the file. If the file changed, select it again.
- If you attach the same file again, ChatCut reuses the copy already in the project.
How do I import Google Drive files?
- In a project, open + → Connector → Google Drive and connect your Google account.
- Open Choose from Google Drive on the web or Choose Drive files on Desktop. Select the media in Google Picker, then select the files you want to use in ChatCut.
- On the web, add the selected files to import them into the project’s Media Pool. In Desktop, use Import selected in the project library, or Add to chat in the chat picker. A chat attachment references the file until the Agent needs the original.
What are the file size limits?
| Media | Limit |
|---|---|
| Dropbox and Google Drive audio and video (ChatCut Desktop) | Up to 1 GiB per file |
| Dropbox and Google Drive images, GIFs and SVGs (ChatCut Desktop) | Up to 512 MiB per file |
| X video (MP4) | 0.5 to 140 seconds, aspect ratio between 1:3 and 3:1, up to 128 MiB |
| YouTube MP4 | Up to 512 MiB. The Web Agent accepts a local MP4 export up to 128 MiB from the same editor tab. |
How do I publish to X?
- Export your video as an MP4 from the project. On the web, export it locally in the same editor tab and keep that tab open; a cloud export or an export saved to a file cannot be used. A post can also be text alone or carry up to four images from the project.
- Connect X from the chat box (+ > Connector > X), then ask the Agent to publish. Include the post text.
- The Agent prepares a draft without uploading anything. It names the account, shows a form in the chat with the media and the post text, and tells you how many credits the post costs.
- Edit the text if you need to, then submit the form. Nothing is uploaded or charged before you submit.
- ChatCut uploads the media, creates the post and follows it until it is published. The Agent replies with a link to the live post.
Things to know:
- You confirm, never the Agent. The Agent cannot submit the form for you. If you edit the text so the post would cost more, nothing is posted and you confirm a new draft. A new draft replaces one you have not submitted, and an unsubmitted draft is lost if you refresh or restart.
- Posting without a review is opt-in. Only when you explicitly ask the Agent to post without confirming, and give it the complete post, does it publish in one step.
- Links cost more. X charges far more for posts that contain a link, and the Agent tells you when that applies.
- Posts are public. X has no private drafts, so a post from a public account is visible right away. For a protected account, only approved followers see it.
- Post text is limited to 280 characters.
- An uncertain result is not retried. If ChatCut cannot tell whether a post went through, it shows Publication status is uncertain. Check its status before trying again. Ask the Agent to check the post’s status rather than publishing again.
Credits for publishing are charged to your ChatCut balance. See Credits for how credits work.
How do I upload an export to YouTube?
- Open the project and connect YouTube with a Google account that identifies exactly one YouTube channel.
- Export an MP4. On the web, open the local export preview in the same tab and click YouTube, or ask the project’s Agent to prepare that local export for upload. In Desktop, ask the Agent to upload a completed MP4 export from the current project.
- Check the channel and video, enter a title, and specify whether the video is made for kids.
- On the web, choose Upload as private and keep the tab open. You can publish the video later in YouTube Studio. Desktop also defaults to private. You may explicitly choose unlisted or public. Check the visibility YouTube actually returns.
- Check processing before sharing the link. If the outcome is unclear, check YouTube Studio before trying again.
How do I read statistics for my posts and videos?
Ask the project Agent how your posts or videos are doing.
- X: it can read up to 100 of your own posts by ID, or a page of your recent posts. Impressions are how many times a post was shown, which is not the same as video views. Video views are reported separately, for the attached video, when X provides them.
- YouTube: ask for the statistics of a video you own by its title or URL, or ask for recent uploads. A lookup by ID accepts up to 50 owned videos.
- A missing number means the platform did not provide it. It does not mean zero.
- There are no date-range, watch-time or revenue reports.
- A handful of posts is a small sample. The Agent should report what it measured and not guess at why a post did or did not spread.
Reading statistics does not use ChatCut credits. X may still count these requests against its own API usage limits.
To see what you have posted to X, click + in the chat box, choose Connector, then Details next to X. Your posts are listed under Published.
Prompts you can copy
Connect my X account.
Look through my Dropbox for the clip named interview-raw and add it to this project. Skip transcription for now.
Publish my latest MP4 export to my connected X account with this text: 'Behind the scenes of our new product launch'.
Show impressions and video views for my last five X posts, and tell me which numbers X did not return.
What about privacy?
- Dropbox files stay where they are until you select them. ChatCut reads only what you choose and imports a file only into the project you are working in.
- Disconnecting removes the link from ChatCut.
- Publishing sends the post or video you approve to X or YouTube. Nothing is uploaded until you confirm.
What are the limits and tips?
- Desktop and web. Use the project editor for the full connector list. See ChatCut product facts for how Desktop differs from the web app.
- Keep the project open while a post or upload finishes. On the web, keep the tab open.
- Choose the right project. A Dropbox or Google Drive selection belongs to the project and chat where you made it. If either changes, select the files again.