Scheduling and publishing
Esta página aún no está traducida; aquí tienes la versión en inglés.
You get a posting calendar for the week, slots per account at the times you choose, and at each post’s time a notification. Click it and Reelfold opens the platform’s own upload page, sets the video made for that platform and types the title, text and tags. You check it, make the choices only you should make, and press publish yourself. Reelfold sees the page confirm it and marks the post as posted. YouTube is different: it is published only through YouTube’s official API, from a publish form in the app. Nothing goes out on its own unless you turn on Post scheduled videos automatically for YouTube.

Before you start
Section titled “Before you start”- Finished clips that you approved, packaged per platform (see One master, many platforms).
- Your publishing accounts for each platform. One platform can have several accounts.
- The Mac app. The Claude Code skill can build packages and a schedule, but assisted upload runs in the app’s built-in browser, and YouTube sign-in runs from the app.
Sign in to your accounts once
Section titled “Sign in to your accounts once”- Open Settings › Publishing (also reachable from the Publish page) and add each account: platform, a name like
@myhandle, and its default post times, for example12:00, 19:00. - Press Sign in. The platform’s own login page opens inside the app. Sign in there with the platform’s own email, phone or QR code login. “Continue with Google”, “Continue with Facebook” and “Sign in with Apple” don’t work inside an app’s built-in browser; Reelfold says so when you hit one.
- The built-in browser keeps one persistent login per account on this Mac. The app never stores your password or cookies itself. It shows each account as signed in or signed out by checking whether the platform’s session cookie is set in that account’s own browser session (only the cookie’s name is looked at, never its value), so any page of the platform counts, the creator center home included, and signing in inside the panel updates the state at once.
YouTube signs in differently: see YouTube: sign in and your own Google Cloud client.
Only the platforms you chose under Settings › General › Platforms for new projects count as yours: they appear in a post’s Where, and only they can show “signed out, can’t publish yet” on the Settings status line. An account on another platform is listed apart with no reminders.
Plan the week
Section titled “Plan the week”The Publish page is a week board (also a month view):
- Finished clips wait in Not scheduled. Drag one onto a day, or into a free slot.
- Let AI schedule fills the free slots for you.
- Gaps show where an account has nothing planned on a day it should post.
- Confirm this week marks the scheduled posts as ready.
Series
Section titled “Series”A series keeps a recurring show consistent: its recipe, settings, platforms, accounts and a cadence such as five posts a week. New projects in the series inherit all of that, and the calendar shows where the series falls behind.
Titles
Section titled “Titles”The title at the top of a post’s drawer is editable: click it, type, press Enter (Escape puts it back). It applies to every platform of the post. Platforms that have a title field get their own Title on … field in their caption tab, with that platform’s counter: Xiaohongshu 20 (latin letters and digits count half), Douyin 30, WeChat Channels 16, Bilibili 80, YouTube 100. A title over the limit is marked, never cut. Use the card’s title removes a platform’s own title.
How scheduling works
Section titled “How scheduling works”A scheduled post is not just a calendar entry: Reelfold acts at its time.
- At the time, while Reelfold is running (turn on Settings › Publishing › Open at login so it starts in the menu bar when you log in), you get a notification: “Time to post: title → Xiaohongshu”. The menu-bar icon lists what is due.
- Click it. The post’s page opens with the platform’s upload page on the right, in that account’s session. Reelfold sets the video made for that platform (the 3:4 or 9:16 version for Xiaohongshu, 16:9 for YouTube …) and types the title, text and tags, then outlines the Publish button.
- You check the page and make your choices (cover, topics, AI-content label, who can see it), then press Publish. For YouTube, the right side is the YouTube publish form instead of a web page; you press Publish or Schedule there.
- Reelfold watches the page. When the platform confirms (a success page or “发布成功”), the post is marked posted, with the post’s link when the page shows one. I published it marks it by hand.
- If Reelfold was closed at the time, the posts that came due wait at the top of Publish and Home: “2 posts are due”, each with Post now.
Every post also has Upload in your browser: the platform’s upload page opens in your default browser, where you are already signed in. Reelfold shows the video file to drag in and copies the title, description and tags one at a time; you press publish there, then paste the post’s link to mark it posted.
If the account is signed out, the fill stops and asks you to sign in on the page, then Fill again. If a field is not found (platforms change their pages), the step list shows which one; fill it by hand, and send a page capture (below) so the adapter can be fixed.
Publish a post now
Section titled “Publish a post now”- On the board, open a post and choose Open assisted fill, or click a due post’s Post now.
- Reelfold sets the video file and types the title, text and tags where the page allows it.
- You check everything and make the choices that are yours: category, audience, the AI-content label, a subreddit, a Pinterest board. On B站, for example, the 分区 and 自制 / 转载 are never pre-filled.
- You press publish. The app may outline the button; it never clicks it.
- Reelfold marks the post as posted when the page confirms it; otherwise Mark as posted and paste the post’s URL.
When a platform asks you to sign in again
Section titled “When a platform asks you to sign in again”Logins expire. When the upload page turns out to be a login page, the fill stops there and the account shows as signed out.
- Go to Settings › Publishing and press Sign in again on that account.
- Sign in on the platform’s page in the built-in browser (password, QR code, whatever it asks).
- Return to the post and open assisted fill again. Nothing you prepared is lost.
Assisted fill works for projects that have a publish package. If auto-fill isn’t ready for a platform yet, open its upload page and use copy caption and show file instead.
With the Claude Code skill
Section titled “With the Claude Code skill”Claude can prepare everything up to the upload:
python -m vstudio.batch package --batch B --per-day 2 --start 2026-10-10 --times 12:00,19:00writes per-platform folders, aschedule.csvand a confirmation code.- The project calendar (
python -m vstudio.project calendar ...) defines accounts with their post times, places exported clips in the next free slots, and lists gaps. - Without the app,
uploader: manualprints the upload page, the steps,caption.txt, the cover and a checklist for each post.
YouTube: sign in and your own Google Cloud client
Section titled “YouTube: sign in and your own Google Cloud client”YouTube is published only through Google’s official YouTube Data API, never in the built-in browser.
- In Settings › Publishing › YouTube, choose how Google sign-in works: Reelfold’s Google app (when your build includes it) or My own Google Cloud client.
- Press Sign in with Google in your browser. Google’s sign-in opens in your system browser. Reelfold asks to upload videos to your channel and to see your channel’s name and playlists; it cannot edit or delete your videos. Tokens are kept in the macOS keychain. You can disconnect there at any time, or at myaccount.google.com/permissions.
- On a YouTube post, fill in the form (title, description, tags, category, visibility, the audience question YouTube requires, the altered or synthetic content label, Publish as a Short, the cover as thumbnail, a playlist) and press Publish, or choose At a time and press Schedule. A scheduled post is uploaded now as private; YouTube makes it public at that time, even if your computer is asleep.
Reelfold’s Google app shows Google’s “unverified app” screen (Advanced → Go to Reelfold) and allows at most 100 people until Google has verified it. Google keeps uploads from a Google Cloud project that has not passed YouTube’s API audit private: make them public in YouTube Studio. The default quota is about 6 uploads a day per project.
To use your own Google Cloud client (about 10 minutes, once):
- Open console.cloud.google.com and create a project (any name).
- APIs & Services › Library: enable YouTube Data API v3.
- Google Auth Platform (OAuth consent screen): user type External, app name, your email. Under Audience, add your own Google account as a test user.
- Data Access: add the scopes
youtube.uploadandyoutube.readonly(andyoutube, only if you want playlists). - Clients › Create client › application type Desktop app. Copy the client ID and the client secret.
- Paste them in Reelfold, then press Sign in with Google in your browser. While your app is in “Testing”, Google asks you to sign in again every 7 days; publish it (no review is needed for your own use) to stay signed in.
The Mac App Store edition cannot sign in to YouTube; each YouTube post offers Upload in your browser instead.
Posting scheduled videos automatically (opt-in)
Section titled “Posting scheduled videos automatically (opt-in)”Nothing is posted without your click, except where you turn this on. Once YouTube is connected, Settings › Publishing › YouTube has Post scheduled videos automatically (off by default). With it on, scheduled YouTube posts are uploaded about an hour ahead as private with YouTube’s own publish time, so YouTube publishes them at your time even if your Mac sleeps. If Reelfold was closed at the time, a post up to 6 hours late is uploaded right away; later than that you get the notification instead. A failed upload is tried up to 3 times.
| Platform | Official API in Reelfold |
|---|---|
| YouTube (and Shorts) | Available. The only path for YouTube. |
| TikTok | Not yet. Direct posting needs TikTok’s app audit. Until then: assisted fill. |
| X | Not yet. Posting needs a paid API tier. Until then: assisted fill. |
| Not yet. Needs a Business or Creator account linked to a Facebook Page and Meta app review. Until then: assisted fill. | |
| Chinese platforms | No public posting API for individual creators. Assisted fill. |
With the skill, official APIs stay off by default; where you turn one on, every upload still needs the confirmation code of the exact package you reviewed.
When auto-fill misses a field: capture the page
Section titled “When auto-fill misses a field: capture the page”Platforms change their upload pages. Each platform’s fill steps live in a small adapter file; the Xiaohongshu and Douyin ones look for fields by their placeholder and label text (“填写标题”, “作品简介”, the “发布” button), with fallbacks, and are marked unverified until checked against your live page.
- Open the upload page in the built-in browser (a post’s page, or Settings › Publishing → the account’s upload page) and add a video so the whole form shows.
- Press Capture this page in the browser bar.
- Reelfold saves a redacted copy of the page structure to
~/Library/Application Support/Reelfold/captures/and shows it in Finder. It keeps tags, classes, roles, placeholders and short labels; it drops cookies and storage (never read), what you typed, editor contents, images, links and anything that looks like a name, ID, phone number or e-mail. - Send that file to whoever maintains your adapters (or open an issue). The fixed adapter goes in
~/Library/Application Support/Reelfold/adapters/without rebuilding the app.
Options worth knowing
Section titled “Options worth knowing”| Option | What it does |
|---|---|
| Default post times | Per account; new calendar slots use them. |
| Open at login | Starts Reelfold in the menu bar at login so notifications arrive on time. |
| Post scheduled videos automatically | YouTube only, once connected: scheduled YouTube posts go out on their own. Off by default. |
| Video length | Settings › Publishing › Video length: your own shortest and longest per platform. Every plan keeps to it. |
| Series cadence | Posts per week the calendar expects for the series. |
| Account tier | Some limits depend on it, for example X Premium. |
| AI label | Every Chinese platform, YouTube, TikTok and Meta have an AI-content toggle. You tick it; the checklist reminds you. |
Example prompts
Section titled “Example prompts”- “Schedule these 12 clips over the next two weeks: Xiaohongshu at noon, Douyin at 7 pm, one a day each.”
- “Make ‘Interview tips’ a series that posts five times a week on my main Xiaohongshu account.”
- “Open the upload page for tomorrow’s Douyin post and fill it in.”
- “What’s missing from this week’s calendar?”