VENI
GUARD
OVERVIEW
• SYSTEM STATUS

Host Bot

Not running

Music Bot

Queue empty

Zoom API

Configuration

Uptime

Server runtime

🖥️ Server Host

Open this dashboard from any Mac or Windows browser — bots and guards always run on the host below.

Basic Setup Checklist

Finish these to go live on Zoom Basic (free). Open Zoom Marketplace

    Quick Actions

    Hard Reset force-kills stuck music, clears the queue, and stops all bots.

    GUARD
    ACTIVE
    MONITORING
    • IDLE

    BLOCKS TODAY

    0
    Total interferences neutralized

    LAST CLEANUP

    Never
    Network + Audio

    GUARD UPTIME

    Since last activation

    Active Audio Chain

    MacBook Air Speakers
    Routed through BlackHole for clean pass-through

    Recent Interventions

    FULL LOG
    No interventions yet. Guard is quiet.

    Command Console

    Bot Services Monitor

    Cloud-Synced Control Room
    Loading bot statuses...
    Active Monitoring Device
    Mac Mini (VeniMac)
    GUARD
    HOST
    SESSION
    • HOST BOT

    Start Zoom Session

    Join the Zoom meeting normally with your personal Zoom account as co-host or host (no separate bot participant in this simplified setup). Multi-pin, spam protection, and chat promo all work from your co-host privileges + API. Use your personal login for full host powers (multi-pin, etc.).

    Schedule Meeting

    Connect Premium Meeting

    Paste your personal premium Zoom join link (from Zoom app → Invite or your recurring Personal Meeting ID). This registers the room for promos, Room VPN, webhooks, and co-host flow — then opens Zoom on this Mac. Sign in as Wholelotofreadung@proton.me (or your co-host account).

    THEHOLEROOOM INVITE

    Global link for participants you want as co-host. They type their Zoom name — you get a notification in #cohost-approvals.

    GUARD
    GROK
    ADMIN
    • CHAT ONLINE

    GrokBot Admin

    Server troubleshooting assistant

    Server Uptime

    Live snapshot on each message

    Quick Help

    Ask anything
    DB lock, tunnel, spam, audio, Zoom

    🤖 GrokBot — Server Admin Chat

    Talk to Grok directly on the server. He reads live status (bots, logs, launch agents) and guides you and other admins on the best fix for any issue.

    Live Server Snapshot

    
                
              
    GUARD
    SPAM
    SHIELD
    • SPAM ACTIVE

    🖥️ This Host Machine

    Spam guard runs on the computer where this server is installed — not on the device you open the dashboard from.

    Detecting…
    Use after moving the server to another Mac (mini ↔ Air) or when audio/speaker names change.

    Spam Guard

    Monitors Zoom main chat

    Reports Today

    0
    Spammers caught & logged

    Blocklist

    0
    Names blocked from rejoining

    🛡️ Spam Guard Settings

    ZoomOSC mode — ZoomOSC on your Mac forwards chat to the server via audio-shield bridge; spam is deleted and apology messages posted back via /zoom/chatAll.

    Spam Reports

      Blocklist

        Test Detection

        ZoomOSC Setup

        1. Open ZoomOSC v4 on Mac (ports 9090 in / 9091 out)
        2. Start audio-shield guard on Mac — forwards OSC chat events to cloud webhook
        3. Join Zoom as co-host on the Mac with ZoomOSC connected
        4. Spam delete + guard messages post via /zoom/chatAll through the Mac bridge
        GUARD
        POLICY
        SYSTEM
        • POLICY LIVE

        CAMERA CHECKS

        0/9
        Participants in grace period

        ACTIVE CHECKS

        0
        Participants in grace period

        MULTI-PIN

        0/9
        Provided participant checks

        Room Policy Settings

        Please turn ON your camera now. You have (seconds) seconds before being moved to the waiting room.

        Live Participant Checks

        When someone joins, they get 20 seconds to turn on camera. A warning is sent before waiting room.

          Multi-Pin Queue

          Pin these participants in Zoom: View → Multi-speaker → select up to 9 people below.

            Test Join (no webhook needed)

            GUARD
            COHOST
            APPROVALS
            • APPROVALS LIVE

            Pending Approval

            0
            Waiting for your approval

            Ready to Promote

            0
            Approved and joined meeting

            Trusted Co-Hosts

            0
            Auto-approved next time

            THEHOLEROOOM INVITE

            Global co-host invite link — share anywhere, same path every time.

            Trusted Co-Hosts

            Names you've approved before are saved here and auto-approved on future requests. You only manually approve someone the first time.

              First-Time Approval Queue

              Only new names show here. Trusted co-hosts skip this and are auto-approved.

                How it works

                1. User opens /theholeroom-invitecredentialsnameclaim roleDiscord + Telegram promo tracking; host bot assigns cohost in Zoom
                2. First time? You approve manually — they're saved as trusted
                3. Already trusted? Auto-approved instantly — no action needed
                4. When they join Zoom, you get a promote notification
                GUARD
                MIX

                Mix Studio — DJ Pro

                Dual-deck web mixer + djay Pro on Mac — Audio Guard routes BlackHole into Zoom.

                Queue: 0 Library: 0 Bridge Mac bridge Output Audio guard: off
                Library
                Deck Idle
                BlackHole
                Zoom
                MIX
                LEFT
                DECK A
                HI
                MID
                LO
                VOL
                Load a track
                0:00
                BPM 128 bpm
                KEY 0.0
                LOOP
                Neural Stems
                Vocals
                Drums
                Bass
                Other
                EQ
                HI
                MID
                LO
                XFADE A↔B
                RIGHT
                DECK B
                HI
                MID
                LO
                VOL
                Load a track
                0:00
                BPM 128 bpm
                KEY 0.0
                LOOP
                Neural Stems
                Vocals
                Drums
                Bass
                Other
                Nothing playing
                Queue a track

                EQ & Audio Guard

                Route music through BlackHole into Zoom — block interference, allow your DJ pass-through.

                Guard: inactive

                Crate & Pre-load

                  Pre-load sources

                  djay library

                  Apple Music

                  Veni SoundCloud

                  Queue

                    GUARD
                    MUSIC
                    PLAYER
                    • MUSIC ACTIVE

                    Music Auto Bot

                    Runs music in the Zoom room — extension of host bot. Play, skip, queue, upload, and pre-load to auto mix.

                    Add Music

                    YouTube / Downloader

                    Paste any YouTube or music URL — downloads via yt-dlp

                    Veni SoundCloud

                    Paste a SoundCloud track URL

                    Apple Music

                    Paste Apple Music URL or search your library

                      From Your Computer

                      Upload mp3, m4a, wav, flac, aiff, ogg

                      📁

                      Drag & drop audio files here

                      Mac Audio Link

                      Links this Mac to the dashboard so you always see what is playing (afplay → BlackHole → Zoom).

                      Mac: checking… Playback: idle

                      ./scripts/mac-zoom-music-bridge.sh
                      Veni

                      Nothing playing

                      Queue a track to get started

                      Queue

                        PROMO
                        ZOOM
                        ANNOUNCE
                        • ROOM BROADCAST

                        Announcement — Zoom Room Chat

                        Send a one-off message or set Auto Promo to post to the room chat on a timer.

                        Auto Promo Timer

                        Posts the message above to Zoom room chat automatically.

                        PROMO
                        ROOM
                        PROMO
                        • ZOOM ROOM CHAT

                        ✅ Finish Zoom Room Install

                        Join Zoom as co-host on your Mac with ZoomOSC v4 and audio-shield guard running. Click below to set the room target and start promo timer — promos post via /zoom/chatAll.

                          Room Promo

                          Zoom main chat

                          Interval

                          20m
                          While room is open

                          Promos Sent

                          0
                          Not sent yet

                          🎯 Target Room (any Zoom link)

                          While you’re in a Zoom room as co-host, click Grab Room I’m In — it reads the invite link from your clipboard (copy from Zoom: Invite → Copy Invite Link).

                          Room promo posts to Zoom main chat via ZoomOSC /zoom/chatAll on your Mac. Audio-shield bridge must be polling.

                          📣 Zoom Room Promo

                          Posts promos in main chat on a timer with a fresh quote each time — themed on “if you’re here, nothing else matters.” Delivered via ZoomOSC on your Mac (you must be co-host).

                          Custom Quotes (optional)

                          One quote per line. Leave empty to use the built-in rotating quotes. Each promo picks a new quote until all are used, then reshuffles.

                          Auto Promo — Regular Room Promo (10 sec blast)

                          Same promo as room-promo (quotes + join link) but fires every 10 seconds for a longer run. Set the room on room-promo first, or grab it below.

                          Auto Promo

                          Every 10 seconds

                          Mins Left

                          Until timer ends

                          Promos Sent

                          0
                          Not sent yet
                          or end at

                          Target room: set on room-promo or grab above.

                          PROMO
                          IDLE
                          TELEGRAM
                          • TELEGRAM OUTREACH

                          Telegram Promo

                          Every 1 minute

                          Messages Sent

                          0
                          Not sent yet

                          Channel Outreach

                          Per-group status

                          Auto Room Promo Bot

                          My folders (active): native Telegram forward from channel 2159507200 — never re-uploaded, premium emojis preserved. Shows “Forwarded from …” in groups.

                          Turn off to pause promos — your Telegram account stays connected (no login code).

                          Stop = pause only (no code). Full Stop = end timer completely (still no code — only Disconnect Account below needs a login code).

                          Your Telegram Account

                          Uses your account (not the bot) so premium emojis work. After the first login, the server auto-reconnects — no need to log in again unless you revoke the session in Telegram.

                          Your phone number only — NOT your API ID or hash. SA: 082… or +27… · US: +1…

                          Promo Channels (rotate every minute)

                          Forwards a different post from your channel(s) every minute to all folder groups — premium emojis kept. One channel ID per line.

                            Promo OK folder (recommended)

                            Only groups where a manual forward works on your phone belong here. The bot then broadcasts to that folder only — no admin-only or banned groups.

                                Admin invite links

                                Telegram cannot auto-promote your personal account — a group owner must tap a link, then promote you manually. Bot links can request admin when adding the bot.

                                Folders to broadcast

                                Folders come from your logged-in Telegram account — not the bot token.

                                Uncheck folders to skip — or use Promo OK folder only above. If you switch accounts, refresh and re-pick folders.

                                  Manual Groups (optional)

                                  Only needed for manual mode. Otherwise use single or auto mode above.

                                    Super Promo Admin

                                    Blasts promos every second for the time you pick. Password: password

                                    Unlock Super Promo

                                    Outreach by Channel

                                    Status for every group/channel the promo is sent to — last run, delivery count, and errors.

                                    Status Channel / Group Folder Deliveries Last Run Promo
                                    Load outreach report…
                                    PROMO
                                    AUTO
                                    GROUP
                                    • AUTO OUTREACH

                                    Auto Group Promo

                                    Log in once — your session auto-reconnects on server restart. After you start once, promo runs in the background whenever you open the dashboard or restart the server. Use Stop to turn that off.

                                    Step 1 — Connect Telegram

                                    Uses your account (not @venipnp_bot) so premium emojis stay intact. API keys go in .env — phone is your real mobile only.

                                    Outreach by Channel

                                    Live status for each group your promos reach.

                                    Status Channel / Group Folder Deliveries Last Run Promo
                                    Refresh to load channels…
                                    PROMO
                                    DISC
                                    DISCORD
                                    • DISCORD BOT

                                    Discord Bot — Direct Link to Veni Server

                                    This bot is a live copy of your dashboard on Discord — promo, music, host, and Audio Guard all run through the same Veni server connection.

                                    Open Discord Bot

                                    Loading…

                                    Do everything from Discord

                                    Quick actions (dashboard → Discord)

                                    Setup (one time)

                                    1. Click Open Discord Bot above to add the bot to your server
                                    2. Bot token + guild ID live in .env on the Veni server (Railway)
                                    3. Channels: #zoom-party (text) + Music (voice)
                                    4. All slash commands sync automatically when the bot starts

                                    Add to Library

                                    SoundCloud

                                    Upload Files

                                    Music Library

                                      Create Playlist

                                      Your Playlists

                                        Meeting History

                                          Server Settings

                                          Your Avatar

                                          This picture appears in the sidebar, music deck, monitor, and desktop apps.

                                          Avatar preview

                                          JPG, PNG, WebP, or GIF (transparent PNG/GIF recommended) — max 5 MB. Also click your sidebar avatar to change it.

                                          Theme Customizer

                                          Choose your interface design mode. This theme will be synced and stored locally.

                                          Zoom App Setup (one app does both)

                                          Create one General App at marketplace.zoom.us with Server-to-Server OAuth + Event Subscriptions. Paste credentials into .env on your Mac, then restart the server.

                                          Tunnel & Permanent Links

                                          Set your Cloudflare Public Hostname once — get a permanent co-host invite link that never expires.

                                          Open Tunnel Helper

                                          Chrome extension: load ~/my-bot-server/browser-extension unpacked in Chrome.

                                          Zoom Webhook

                                          In your Zoom app → Feature → Event Subscriptions. Tunnel must be running.

                                          System Options

                                          Use Hard Reset when music won't stop or bots are stuck.

                                          Audio Routing

                                          Route music through Loopback (or similar) and set Zoom's microphone to that virtual device. The music bot plays locally via afplay — your virtual audio cable sends it into the Zoom call.

                                          Cloud Video

                                          Image → MP4 on thrxxl

                                          Runs on your Railway server. Same dashboard session. Does not use Mac RAM.

                                          provider —

                                          Generate

                                          Upload a still. Default is Wan 2.2 real AI (GPU space — natural motion). Use “CPU only” only for quick camera pans. May wait if the free GPU queue is busy.

                                          
                                                      
                                                    

                                          Recent jobs

                                          Stored on Railway volume /app/data/cloud-video/

                                            Video jobs

                                            All cloud-video renders on thrxxl. Open VIDEO → cloud-video to create a new one.