Vodmill docs
v1.0.0
Get help
● Reference · Questions

FAQ
short answers, with the page that has the long one.

Questions buyers and their customers ask most, grouped: the product, content rights and platform policies, campaigns and money, technical limits.

01The product

Is this a hosted service?

No. You install Vodmill on your own server and run it under your own brand. The author runs no hosted version for you (Installation).

Does it work without any API key?

Uploading, editing, captions, layouts and rendering do. Analysing a source needs transcription: with local whisper.cpp that is possible with no key at all, and moments are then picked by the built-in picker. An Anthropic key adds AI picking, titles and post texts (What works without which key).

Which AI services does it call, and who pays?

Anthropic (Claude) for moment picking and writing, and ElevenLabs or a Whisper-compatible provider for transcription, each only when you enter its key. You pay those providers directly. Their fees are not part of the purchase.

Can I run it on shared hosting?

No. It is a long-running Node.js process that starts ffmpeg and stores large files. Use a VPS (Requirements).

Does it need a GPU?

No. Rendering, face detection and local transcription run on the CPU.

Which languages does it handle?

The interface is English. Transcription languages depend on the provider or whisper model you choose. Captions are drawn with fonts that cover Latin and extended Latin scripts (Languages).

Does it generate video or avatars?

No. It clips, reframes and captions footage that already exists.

02Content rights and platform policies

Whose videos may users clip?

Only content they own, or content whose owner gave them permission to clip it. Every upload and every import asks the person to confirm the statement "I own this content or have the owner's permission to clip it", and the server stores who confirmed it and when. The software cannot check that the statement is true: your terms of service must require it, and you decide how to act on complaints.

Is import from a link safe to offer?

It is off by default and is your decision as the operator. The video platforms' terms restrict fetching their content, and copyright law applies to what users bring in. It is meant for a creator's own videos and streams and for content with permission. Instagram and TikTok links are always refused (Imports).

Will clips made with it be monetised by the platforms?

That is up to each platform, not this software. Platforms have their own rules on reused and repetitive content, on disclosure of paid promotions, and on spam. Having permission from the original creator does not by itself make a clip eligible for a platform's revenue programmes. Users must read and follow the rules of the platforms they post on.

Does Vodmill promise views, reach or income?

No. The score on a clip is the product's own estimate of how well a moment works as a clip, not a forecast. Campaign amounts depend on real views and the campaign's terms. Nothing in the app or in this documentation promises views, reach, earnings or sales.

What about music?

The music library starts empty. Upload only tracks you own or hold a licence for, with their credit line. Platforms may still mute or claim videos with music; that is between the user and the platform.

Do clippers have to disclose paid campaigns?

Advertising rules in most countries, and the platforms' own rules, require paid or sponsored posts to be disclosed. Brands can require a caption text, hashtags or mentions in a campaign's rules to help with that. Complying is the brand's and the clipper's responsibility; ask a lawyer about your market.

Who answers a copyright complaint?

You, the operator. The console's Sources page shows who added a source and whether the rights statement was confirmed, and lets you delete it.

03Campaigns and money

Does Vodmill pay clippers?

No. It keeps a ledger: what each clipper is owed and what was recorded as paid, with a reference. You or the brand pay outside the software (The ledger principle).

Does it take the brand's budget by card?

No. The budget is a number the ledger reserves against. How you collect it from the brand is your arrangement.

Which platforms' views are counted automatically?

YouTube (with your YouTube Data API key) and Twitch (with your Twitch app keys). TikTok, Instagram, X, Kick and Facebook are reported by screenshot and confirmed by a person (How views are counted).

Can the fraud score reject a clip?

No. A flag only pauses the payout until a person looks. Rejections always cite a rule of the campaign, and the clipper can appeal once (The fraud score).

How high can my commission be?

It is 0 by default and capped at 50 % in code (Your commission).

Do I need a licence to run a rewards programme and pay people?

Paying people, holding money for others and running promotions are regulated differently in each country. The software only records amounts. Ask a lawyer or accountant before you launch.

Can I sell subscriptions without Stripe?

Yes, by hand: set each workspace's plan and credits in the console and invoice your clients yourself (Turn selling on).

04Technical

Can it post to TikTok or Instagram?

Not directly. Customers reach those networks through their own Postiz, or a webhook to an automation tool (Publishing).

How long can a source be?

The plan decides: "Longest source video" is 60 minutes by default and can be raised to 1440. The largest upload is 8 GB by default and can be raised to 200 GB.

Which aspect ratios and frame rates?

9:16, 1:1, 4:5 and 16:9; 30 frames per second, and 60 when the operator and the plan allow it.

Can I add my own caption fonts?

Not from the interface in 1.0.0. The font list is in packages/captions/src/fonts.ts; adding one is a source change.

Can several servers share one install?

Version 1.0.0 is built as one server with SQLite and local files. Scale up the machine rather than out.

Does a backup contain the videos?

Only when you ask for it: npm run backup -- --with-media packs the source videos and rendered clips with the databases. A plain npm run backup holds the databases, logos and music only (Backups).

Does it work without an AI key?

Yes, as long as transcription is set up. Clips are then picked by the built-in picker and marked "Picked without AI", with a hook line, titles and hashtags taken from the clip's own words; a Claude key adds reasons written by AI, better titles and the complete-thought check (AI and transcription).

Where is my data?

In DATA_DIR on your server (What is in DATA_DIR). Audio goes to the transcription provider you chose and transcripts to Anthropic when you use them.

Can I change the code?

Yes, within the Envato licence you bought. The full source is in the package, including the console. Keep notes of your changes for updates (Updating).