Skip to content
spacesdrivePublic

About

Every analytics tool wants a subscription. And your data. I built Twiligent instead. YouTube stats. Instagram stats. One dashboard. Runs locally on your machine.

Topics

Resources

Stars

75 stars

Watchers

9 watching

Forks

Repository files navigation

Twiligent

Every channel, folded into one clear picture.

A self-hosted dashboard for your YouTube, Instagram and Reddit numbers.
Publish to Instagram, schedule posts, and answer comments automatically.
It runs on accounts you own, mostly on free plans.

Documentation  ·  Try it  ·  Run your own  ·  Report an issue

CI Latest release MIT license GitHub stars


The Twiligent Overview: every account's audience, views and likes side by side

Why Twiligent

If you post in more than one place, your numbers live in more than one place. YouTube Studio has some of them, Instagram has others, and Reddit keeps its own. Most tools that bring them together charge a monthly fee and ask for access to your accounts.

Twiligent puts them in one dashboard that you host yourself. Your data stays in your own database, your keys stay on your own server, and it runs mostly on free plans.

What you can do

A YouTube channel's analytics page

See each channel in depth

Views, subscribers, engagement and growth for every YouTube channel, with Shorts and long videos compared and your best videos ranked.

An Instagram account's analytics page

Know what works on Instagram

Followers, engagement rate, the best day and hour to post, and how Reels, photos and videos compare.

The Publish page with post settings

Publish now, or at the hour you pick

Post photos, Reels and Stories to Instagram, or schedule them. The server publishes within 15 minutes of that time, even with your browser closed.

Comment automation rules and activity

Answer comments automatically

When someone comments a keyword such as GUIDE, they get your private reply and link within seconds, a public reply under their comment, or both.

The Videos explorer table

Find any video or post

Search and sort every video, Short, Reel and post across your accounts, by views, likes, comments or engagement.

The Accounts page with connected channels

Bring every account together

Add YouTube channels by link or handle and Reddit profiles by username, connect Instagram with one sign-in, and refresh them all at once.

The recordings use a made-up brand, Northwind Kitchen. No real account data is shown.

How it works

Twiligent is two small apps: the dashboard in your browser and an API on Cloudflare's network. The API reads your stats from each platform's official API, keeps your accounts in your own Supabase database, and runs the scheduled work.

flowchart LR
    You([You, in the browser]) --> App[Dashboard<br/>Cloudflare Pages]
    App --> API[API<br/>Cloudflare Worker]
    API --> DB[(Your Supabase<br/>database)]
    API --> Platforms[YouTube, Instagram<br/>and Reddit APIs]
    Clock([Every minute]) --> API
Loading

The Worker wakes up on a timer, so scheduled posts go out and comment replies are sent without anyone keeping a tab open. Read more in How scheduling works.

Get started

You can use Twiligent in two ways.

Use an existing instance

If someone gave you a link to their Twiligent, sign in there. There is nothing to install. Start with Sign in and first steps.

Run your own

You need a free Cloudflare account, a free Supabase project and the API keys for the platforms you want. The self-hosting guide walks through every key, step by step.

To try it on your own machine first, you need Node.js 22.18 or newer:

git clone https://github.com/spacesdrive/twiligent.git
cd twiligent
npm install
npm run dev

The dashboard opens at http://localhost:5173. It needs a few keys in backend/.dev.vars before it can load data; Environment variables lists each one.

Documentation

Everything else lives in the docs at twiligent.ujjwal.fyi/docs.

If you want to Read
Learn the basics Introduction and Members and administrators
Add your channels and accounts Connect your accounts
Understand the numbers Read your analytics
Post and schedule to Instagram Publish and schedule
Reply to comments automatically Reply to comments automatically
Host your own copy Self-hosting overview and the Launch checklist
Fix a problem Troubleshooting and the FAQ
Know how your data is kept safe Security

Contributing

Contributions are welcome. Every change starts with an issue, so look through the open issues first, or open a new one to describe what you have in mind. Then fork the repository, make your change on a branch, and open a pull request that names the issue.

The engineering docs in docs/ explain how the code is organized. Start with CLAUDE.md: it maps the project and links to the coding and writing standards.

License

Twiligent is open source under the MIT license. Work by others that the project includes is credited in THIRD_PARTY_NOTICES.md.


Built by spacesdrive. If Twiligent helps you, a star helps others find it.

About

Every analytics tool wants a subscription. And your data. I built Twiligent instead. YouTube stats. Instagram stats. One dashboard. Runs locally on your machine.

Topics

Resources

Stars

75 stars

Watchers

9 watching

Forks

Contributors

Languages