Getting started

Find your way into Villow.

Run your own private Villow or join one run by someone you trust. One person sets it up, then friends sign in. Start with the standalone extension if you'd like to try the browser controls first.

  • Free and open source software
  • Hosting needs and group costs are still being tested

Three ways to begin

Create your private Villow

Villow Setup walks you through creating and connecting the accounts your Villow runs on. The setup app is for Windows today; macOS and Linux availability is TBDmacOS and Linux availability. The download link is still being prepared.

The setup journey

  1. Prepare your accounts

    You'll need a Google account, a Google Cloud project for YouTube access, Vercel for hosting and Supabase for the database. Setup guides the connections.

  2. Build your Villow

    Follow Setup to create and connect your projects. Review the provider plans and allowances before creating anything.

  3. Sign in and choose your setup

    Choose your name, time zone, country and daily limit. Review your sharing choices for people on your Villow.

  4. Use it on your devices

    Open your Villow address in a browser. Add it to the home screen on iPhone, iPad or Android for an app-like experience.

  5. Connect your YouTube browsers, if you want

    Install the extension and use a connect link from Villow. Each browser needs its own connection. Check coverage.

  6. Invite friends, if you like

    One person hosts; friends sign in and choose their own limits. Invitation guidance.

Join a friend's Villow

Ask the owner for their Villow address and to allow your Google account to sign in. You don't need to run Setup or create hosting accounts yourself.

Sign in with Google, choose your viewing settings, and review what you want to share with people on this Villow. Social features, ratings and the extension are optional.

Only join a Villow run by someone you trust. Its owner controls the hosting and database and can access stored data. Sharing controls govern what ordinary members see through the app; they don't hide the database from its operator.

Before you create one

  • A Windows computer for Setup. This is separate from the devices you'll use Villow on.
  • Google, Google Cloud, Vercel and Supabase accounts for your own installation.
  • Time to follow the account and consent steps. Setup duration hasn't been tested with new users yet: TBDsetup time in minutes.
  • A willingness to maintain your projects and check their usage, updates and backups.

Free software. Hosting needs still being tested.

Villow and Villow Setup are free and open source. Your installation runs on your own provider accounts.

We haven't established a reliable capacity guide or group cost estimate yet. Free allowances may suit some use, but we can't promise free hosting for you or your group, or say that a paid plan is necessarily required. Check current provider terms, allowances and billing in your accounts.

Invite people you trust

Give your friend access through your Google Cloud project's allowed-user setup, then send them your Villow address. Exact current steps: TBDexact steps to add a friend in Google Cloud.

While an external Google OAuth project is in Testing, YouTube authorization normally expires after seven days, so people may need to authorize again. Production and verification guidance is still being confirmed: TBDwhether Setup covers moving to Production, and what's involved.

Know what you're joining

  • Villow adds no ads and sells no viewing data. YouTube's embedded player may still show YouTube ads.
  • Review Google permissions and the privacy model before authorizing.
  • Operators are responsible for their installation and its use of YouTube API Services.
  • Private viewing measurements stay in your installation. Optional feedback you submit goes to Fix the Web.

See the everyday experience first.