getty (λ)

The platform tools for live streaming on Odysee. This includes overlays, tip alerts, chat, giveaway system, creator analytics and much more. Now integrated with Wander Wallet and Odysee for login and encrypted data isolation with security tokens for your widgets and overlays.

The vision: To provide Odysee streamers with comprehensive tools for their livestreams on Odysee. Everything is easy, free, and requires no registration. Enjoy the app and stay tuned for more updates in the future.

🔥 Online version from app.getty.sh. This is an optional online version if you don't want to use the localhost version. You only need to configure once and save the changes. Then, open OBS and integrate the widgets.

We recommend login with your Odysee account and verify your session with Wander Wallet to set up your account.

Go live and upload content on Odysee

Odysee is a blockchain-based media platform. We host all kinds of media such as images, articles, PDFs, audio files, etc., but we're best known for hosting videos. Odysee seeks to recapture the spirit of the early 2000s era internet. Rather than favouring corporate content such as late night talk shows, network television, and TV news, Odysee is a place for everyone, including independent creators. Create a channel and go live.

Learn more about creating and setting up a wallet on Odysee, visit the documentation.

About Wander

Wander App is a secure and easy-to-use digital wallet for Odysee, allowing you to authenticate to getty without the need for traditional passwords. It is essential for accessing Getty features such as widget configuration and encrypted data management. Download Wander from https://www.wander.app/ to get started.

Some features

1. ⚡ Quick start: Log in with your Odysee account and set up your channel analytics and livestream statistics.
2. 🔔 Real-Time Notifications: Get alerts for your AR token tips, chat messages, donation goals and the latest tip instantly.
3. 🎨 Unlimited Customization: Change colors, fonts, styles, titles and more to fit your style.
4. 🔄 Standalone Widgets: Activate only the ones you need, either 1, 2 or all.
5. 📢 Discord/Telegram Integration: Send tip notifications to your Discord server or Telegram group.
6. 🗣 Text-to-Speech (TTS): Listen out loud to chat messages when you get tips!
7. 🎉 Custom commands: Increase the excitement of your giveaways with custom commands!
8. ❇️ Announcement: Create random messages for your viewers.
9. #️⃣ Social media: Show your social media accounts.
10. 💬 Live Chat: Add a chat widget to your OBS with different themes.
11. 📈 Real-time and historical statistics of your livestream in Odysee.
12. 🎉 Achievements System: Receive real-time achievement notifications.

Do you want to use getty locally?

Node.js

• Use your favorite terminal.
• Install Node.js 22.x (the project requires Node >=22 <23).
• Enable Corepack (included with Node) so pnpm is managed automatically by the version pinned in package.json:

corepack enable
node -v   # should print v22.x.x
pnpm -v   # Corepack will provision pnpm@10.27.0

• Optional: install pnpm manually (if you prefer not to use Corepack):

npm i -g pnpm@10.27.0

Installation

1. Install OBS Studio, Streamlabs or any software of your choice.

2. Clone this repository or download the files.

3. Open the terminal in the getty folder.

4. Optional: Copy env file and adjust values:

   cp .env.example .env

5. Install dependencies with pnpm (via Corepack): pnpm install

6. Build the app with pnpm run build (runs the full pipeline: copies assets, builds admin + widgets with Vite, syncs dist-frontend/ into public/, reapplies SRI, minifies legacy JS).

7. Alternatively, for faster widget-only iterations:

   • pnpm frontend:build – compile Vite widgets into dist-frontend/.
   • pnpm sync:frontend – copy the build into public/ and refresh SRI attributes.
   • pnpm add-sri – re-run integrity hashing manually if you copy files by hand.

8. Start the server in production mode with pnpm run start:prod.

9. The server will run the app with the address http://localhost:3000.

10. Open getty in your web browser and configure your widgets in admin.

Important: If you download an update from getty, you must repeat the installation process. In some cases, there may be new dependencies to install, so the process may need to be repeated.

Development workflow

• Run the backend in watch mode with Tailwind and the embedded Vite dev server:

  pnpm run dev

This single command serves every public page (landing, welcome, dashboard, 404) through Express on http://localhost:3000, while hot-module reloading is proxied internally from Vite.

• To disable Vite while developing static assets, set GETTY_DISABLE_VITE_MIDDLEWARE=1 before running the command. Without Vite, the server falls back to the latest files inside public/ or dist-frontend/.

• The standalone Vite port is no longer required; keep your browser pointed to http://localhost:3000 for the entire experience.

• Widget build shortcuts:

  pnpm frontend:build  # compile only the Vite frontend
  pnpm sync:frontend   # copy dist-frontend/ → public/ with SRI reapplication

These two commands are useful when iterating on OBS overlays without running the full pnpm run build pipeline.

• OBS smoke tests: see docs/widget-validation-notes.md for the checklist used to validate each migrated widget (URLs, tokens, audio/TTS checks).

Visit getty in the browser:

1. Welcome & landing: http://localhost:3000/ (first-time visits redirect to /welcome so you can choose a language, connect your wallet or login with Odysee).
2. Dashboard: http://localhost:3000/user/<your-id-token>
3. Admin: http://localhost:3000/admin/home

How to add widgets to OBS?

1. Open the OBS Studio software.
2. Add a new "Browser Source".
3. Paste the URL of your widget: (e.g. http://localhost:3000/widgets/chat).
4. Adjust the size, position and color of each widget.
5. You're done! The widgets will appear in your stream. Let's stream!

getty's vision is to help streamers on Odysee manage their own widgets for community interaction. This opens the door to multiple options and resources never seen before. Enjoy the app and look forward to more updates.

Visit getty's official website for more information: getty.sh.

With love for Odysee ❤️

λ