Help & User Guide
Step-by-step guide to the queue, OBS overlays, donations, and integrations.
Quick start
Music in a few minutes.
Driler FM can be running in a couple of minutes: sign in and open On Air — your live control desk. It shows the current track, player state, and the whole queue.
Add music by pasting a YouTube link (regular videos, Shorts, or youtu.be) or a RUTUBE link. The service pulls the preview; once Now Playing shows the track and the player indicator is online, the source is ready.
Connect OBS: in Settings → OBS Links copy the player URL and add it as a Browser Source. Set the size to your scene and enable audio; optionally add the queue link for the “Up Next” overlay.
Check controls: press Play/Pause and Skip and confirm audio. Then go live and manage the queue from On Air—add tracks, reorder, and remove items.
- Sign in and open On Air - your live control center.
- Paste a YouTube link (watch/shorts/youtu.be) or a RUTUBE link and wait for the preview.
- Make sure Now Playing shows the track and the player indicator is online.
- Open Settings -> OBS Links and copy the player URL (queue link is optional).
- In OBS add a Browser Source, set size to your stream resolution, enable audio.
- Optional: add the queue link as a second Browser Source for the "up next" overlay.
- Press Play/Pause or Skip once to verify control and audio.
- Go live and manage the lineup from the On Air page.
Account basics
What matters before you go live.
After sign‑in your account becomes your workspace. It keeps your queue, playlists, history, and stats—everything you need for a steady stream.
Each account has public player and queue links. These are unique tokens: share them only with OBS and rotate them in Settings if a link gets exposed.
If you stream from a shared device, always sign out via the sidebar. Language, theme, and search preferences are tied to your account and load automatically next time.
You can keep multiple tabs open, but playback control follows the most recent command. For stability, keep a single active tab.
- Sign in with email and password; the account keeps your queue, playlists, history, and stats.
- Each account has its own public player and queue links.
- Public links are unique tokens; rotate them in Settings if they leak.
- Use the logout button in the sidebar on shared machines.
- Language, theme, and search preferences are saved per account.
- You can open multiple tabs; the latest action wins during playback.
On Air control
Your live control center.
On Air is your main control center during a stream. The Now Playing block shows the current track, playback progress, and status. You can click the timeline to jump to a specific moment.
Control music directly with Play/Pause and Skip—no tab switching or extra steps. Hover a track in the queue to see extra actions: play now, add to playlist, or remove.
Add music right here: paste a YouTube link and the platform will load the preview and add the track to the queue. To reorder, drag tracks by the grip icon—one move, no delay.
The top bar shows total track count and connection indicators for the player and queue. The sidebar mini‑player mirrors playback state so you can quickly confirm everything is working.
- Now Playing shows the track, progress, and play state; click the bar to seek.
- Play/Pause and Skip keep the flow without alt-tabbing.
- Add input accepts YouTube URLs (watch/shorts/youtu.be) and shows a preview.
- Drag items by the grip to reorder the queue instantly.
- Remove deletes a single entry, Clear removes all pending items.
- Use the star to mark donation tracks; they stay above regular items.
- Hover a row to Play now, add to a playlist, or remove it.
- Header shows total tracks plus player/queue connection indicators.
- Mini player in the sidebar mirrors the current state.
Playback behavior
How the player behaves during a stream.
The player runs automatically: as soon as one track ends, the next one starts from the queue. The entire flow is shown in Now Playing, your main navigation point during a live session.
When the queue ends, the player page becomes transparent so the overlay doesn’t block your scene. If playback is paused, the current frame stays visible until you resume.
After a player reload, playback continues from the same spot. Fast actions like Skip or reordering update the player almost instantly.
If you control the stream from multiple tabs, the last command wins—this keeps things in sync. In OBS, keep the player source open; if the image freezes, just refresh the source.
- The player auto-advances to the next track when one ends.
- When the queue ends, the player page becomes transparent.
- Paused playback keeps the current frame until resumed.
- Reloading the player resumes from the saved progress.
- Skipping or reordering updates the player almost instantly.
- If multiple tabs control playback, the last action wins.
- Keep the player source open in OBS; refresh it if playback looks stuck.
Queue management
Keep the stream under control with clear structure.
The queue is your playback list: the first track is always shown in Now Playing, the rest wait their turn. That order is exactly how OBS plays them on scene.
Add music in three ways: paste a link, use search, or AI suggestions. New tracks appear immediately, and you can start one instantly with Play Now or jump to it via Skip.
Reorder by dragging the grip icon. Use Remove to delete a single track or Clear to wipe the queue. This keeps things tidy without extra steps.
Donation tracks can be starred so they stick above regular ones. To avoid repeats, enable duplicate blocking in Settings. Any track can be saved to a playlist with Add to playlist.
- Add videos by YouTube or RUTUBE link, or from search and AI suggestions.
- The first item is Now Playing; the rest are upcoming.
- Drag items to reorder; the list order is what OBS will play.
- Play now/Skip jumps to the selected entry immediately.
- Remove deletes a single entry, Clear removes everything pending.
- Donation items stay grouped at the top; star toggles donation status.
- Use Add to playlist to save a track for later.
- Duplicate blocking applies to new adds when enabled in Settings.
- The public queue overlay mirrors the same order.
OBS setup
Two links—one for the player and one for the queue.
OBS overlays use two public links: one for the player (current video) and one for the queue (the “Up Next” list). These links define what viewers see on scene.
Go to Settings → OBS Links, copy the URLs, and add them to OBS as Browser Sources. Set the size for your scene (for example, 1920×1080) to ensure correct rendering.
Don’t forget to enable audio for the source. You can either enable Control Audio via OBS or unmute it in the audio mixer. If autoplay fails, refresh the source or the scene and it will start.
Keep the player loaded even if it’s hidden—this speeds up track switches and avoids delays. The queue overlay can be freely resized and placed anywhere on your layout.
- Player link plays the current video; queue link shows next tracks.
- Add each link as a Browser Source in OBS.
- Set the player size to your scene resolution (e.g. 1920x1080).
- Enable Control Audio via OBS or unmute the source in the mixer.
- Turn on Refresh browser when scene becomes active.
- If autoplay fails, refresh the source or the scene once.
- Resize and position the queue overlay to fit your layout.
- Keep the player source loaded even if hidden to avoid delays.
Overlay themes
How the player and queue look on your scene.
The Themes page controls the matching player and queue presentation in OBS: typography, layout density and the way the current track is presented. One selection applies to both public links, so their URLs never change.
The catalog holds 10 themes: 1 on the free plan and 9 with Pro. Switching is instant and needs no source reload in OBS.
Match the theme to the scene: compact variants read better on busy layouts, larger ones with generous line spacing suit sparser scenes.
- Each theme is one matching player-and-queue package.
- 1 theme is free and 9 are Pro.
- Your public player and queue links stay the same.
- Switching needs no source reload in OBS.
Public links & sharing
Shareable, but view‑only.
Public links are ready‑to‑use URLs for browser or OBS that show the player and queue in read‑only mode. They don’t grant control and don’t affect your queue.
Each link contains a unique access token. It’s safe to share with moderators or use in OBS, but avoid posting these URLs publicly.
If a link leaks, rotate the token in Settings—old URLs stop working immediately and new ones replace them in the interface.
You can set the overlay language by adding a locale prefix to the URL. Use different links for different languages or scenes if needed.
- Public links are view-only and never change your queue.
- They work in any browser or OBS without login.
- Use the locale in the URL to set overlay language.
- Share links with moderators or embed them in OBS.
- Rotate the token in Settings if a link leaks.
- A new token replaces old links immediately.
YouTube search
Optional, but powerful.
Search runs through your personal YouTube API key. Add it in Settings—without it, search and AI suggestions are unavailable.
Found videos can be sent straight to the queue or saved to a playlist. Results are filtered by max duration and results‑per‑page to keep them relevant.
Each search consumes your own key’s quota, and the duration filter adds one more call. The quota is counted on Google’s side and resets once a day.
Your quota resets daily in your Google Cloud project. If the limit is reached, search pauses temporarily. You can refine the query or prepare tracks in playlists.
- Search requires your personal YouTube API key in Settings.
- Invalid keys block search and AI suggestions.
- Results can go straight to the queue or playlists.
- Filters respect max duration and per-page limits.
- Each search spends your own YouTube key’s quota.
- Duration filtering always applies and adds a videos.list call (1 unit).
- Quota resets daily in your Google Cloud project; when exhausted, search stops.
- Use focused queries and playlists to save quota.
Playlists
Prepared sets for any mood or format.
Playlists let you collect tracks for shows, themes, or segments ahead of time. It’s an easy way to prep and switch formats—interview blocks, DJ sets, themed hours.
Add tracks via links, search, or AI suggestions. Reorder by dragging—your order is preserved exactly as you set it.
When it’s time to fill the queue, choose a mode: Append adds to the end; Replace clears the queue first and loads the new list. This gives full control of what plays next.
Share a playlist by its ID so others can import it. Free includes one playlist; Pro removes the limit so you can save unlimited sets.
- Create playlists for themes, shows, or segments.
- Add tracks by URL or from search and AI results.
- Reorder tracks with drag-and-drop; positions are preserved.
- Append adds to the end; replace clears the queue first.
- Share a playlist ID so others can import it.
- Free plan allows 1 playlist; Pro unlocks unlimited.
- Use playlists to prep before the stream.
Donations & integrations
Automatic track additions from DonationAlerts and Donatty.
DonationAlerts and Donatty integrations can automatically add YouTube and RUTUBE links from donations directly to the queue—without interrupting the current track and with full sync.
Connect in Settings: DonationAlerts (Pro) uses OAuth, and Donatty (Pro) uses a standard donations widget URL.
You can enable or disable integrations at any time. The connection stays, but new donations temporarily stop entering the queue—useful if you need to pause requests.
Donation tracks are automatically grouped at the top by arrival time. You can manually mark or unmark a track with the star. Duplicate blocking is respected, so repeats won’t be added if it’s enabled.
- Connect DonationAlerts (Pro) in Settings to auto-add YouTube and RUTUBE links from donations.
- Donatty is Pro only: create a regular donations widget and paste its URL in Settings.
- Enable or disable each integration any time without disconnecting.
- Donation tracks are grouped at the top in arrival order and never interrupt playback.
- The donation message must include a full YouTube URL; duplicates may be blocked.
- Use the star in the queue to mark or unmark a donation manually.
YouTube chat bot
Requests from live chat, straight into the queue.
The chat bot reads your YouTube live chat and picks up links viewers post. A matched track joins the queue without interrupting the current one, exactly like a donation request.
It is a Pro feature, connected under Settings: you authorise access to the channel, after which the bot can be paused at any time without revoking that access.
Chat requests follow the same rules as every other source: with duplicate blocking on, a repeated track is not added.
- Needs Pro and channel authorisation in Settings.
- Chat links join the queue without cutting the current track.
- The bot can be paused without revoking access.
- Duplicate blocking applies to chat requests too.
AI video suggestions
Pro feature for fast and accurate search.
AI suggestions are a convenient way to find tracks by genre, mood, instruments, or tempo. The feature is Pro‑only and works with a connected YouTube API key.
Enter a short description—e.g., “slow jazz with saxophone” or “energetic intro track”. AI builds 3–5 search queries and returns relevant videos you can add to the queue or save to a playlist. To protect YouTube quota, searches run for up to 2 queries.
Each query consumes your YouTube API quota. More queries mean higher usage. If results are empty or off, simplify the query and refine keywords.
When the quota is exhausted, search pauses temporarily. Wait for the refresh or use prepared playlists to avoid interrupting the stream.
- AI suggestions require Pro and a YouTube API key.
- Describe mood, genre, instruments, or tempo.
- AI generates 3–5 queries; searches run for up to 2.
- Each query spends YouTube quota; more queries cost more.
- Review suggestions and add them to queue or playlists.
- No results? Try shorter, more specific prompts or new keywords.
- If rate-limited, wait a bit and retry.
History
Fast access to proven content.
History saves every track that played or was removed from the queue. It’s an archive you can return to to rebuild strong lineups or repeat successful shows.
Use filters by status, date, and sort type to find what you need. It helps separate what actually played from what was skipped or removed.
Any track can be re‑queued with one click—respecting duplicate blocking if it’s enabled. It’s a fast way to refill the stream with reliable content.
History helps keep rotation consistent and prevents good finds from being lost. It’s especially useful when the queue runs out and you need momentum fast.
- History keeps played and removed tracks.
- Filter by date range, status, and sort order.
- Requeue any item with a single click (duplicates may be blocked).
- Use history for recurring segments or safe repeats.
- Played vs removed helps you track what actually aired.
- History is your backup when the queue runs low.
Stats dashboard
Rotation insights at a glance.
Stats show how your stream sounds: how many tracks played and which ones repeat most often. It’s a quick way to see which formats work best.
Totals shows the overall count, and Weekly Activity highlights playback by day so you can spot your busiest moments.
Top Tracks lists the most played items for the selected period—use it to identify reliable content and keep quality consistent.
Pick a date range to analyze recent streams or your full history. This helps adjust selections and keep the right pace.
- Totals show how many tracks were played.
- Weekly activity charts show playback by day.
- Top tracks list your most played items.
- Use date ranges to focus on recent streams or all time.
- Stats help you keep reliable music in rotation.
Settings
Tune the platform to your stream format.
Settings combines all key parameters—from the YouTube API key to language and theme. Enable search, AI suggestions, and duplicate blocking for more precise control.
You can also set search limits: maximum video length and results per page. This keeps results aligned with your stream format.
OBS links and public token management live here too. To change links, rotate the token—old URLs become invalid and are replaced automatically.
Integrations with DonationAlerts, Donatty, and YouTube Chat are also connected here. Once enabled, you can toggle them on or off as needed.
- Save and validate your YouTube API key (search and AI need it).
- Control results per page and max duration.
- Toggle whether duplicates are allowed in the queue.
- Copy OBS links for the player and queue overlays.
- Rotate the public token if you need a fresh link.
- Connect DonationAlerts to auto-queue donation YouTube links.
- Connect Donatty (Pro) with a widget URL and enable/disable donations.
- Connect YouTube Chat (Pro) to announce the current track in chat.
- Switch language and theme any time.
Billing & Pro
Upgrade when the basics aren’t enough.
Billing shows your current plan and subscription status. You can see what Free includes and what extra features Pro unlocks.
If you choose Pro, you can subscribe right in this section. After activation, you’ll see payment details and the next renewal date.
Subscription management is always available: update payment details, open the customer portal, or cancel auto‑renew. After cancellation, Pro stays active until the end of the paid period.
Pro unlocks advanced features: AI suggestions, Donatty integration, and unlimited playlists. If you stream regularly, the upgrade pays off quickly.
- Free plan covers core queue and OBS playback.
- Pro unlocks AI suggestions, Donatty, and unlimited playlists.
- Billing shows your current plan and renewal date.
- Upgrade opens a secure checkout flow.
- Cancel keeps Pro active until the period ends.
- Manage your subscription from the Billing page.
Limits & quotas
What can run out—and how to handle it.
The main limit is your YouTube API quota, which is tied to your personal key, not Driler FM. When the limit is reached, search and AI suggestions are temporarily disabled.
AI consumes more quota than a plain search because it runs several queries in a row. Short, specific prompts save a noticeable amount.
Quota resets daily in your Google Cloud project. Use precise queries and prepared playlists to spend it efficiently.
Keep plan limits in mind: Free includes one playlist, while Pro removes the limit. Public links are always view‑only on any plan.
- YouTube quota belongs to your API key, not the app.
- AI suggestions can spend multiple searches per prompt.
- Quota resets daily in your Google Cloud project.
- Free plan includes one playlist; Pro removes the limit.
- Duplicate blocking affects new adds, not history.
- Public links stay view-only on all plans.
Workflow tips
Small details that make streams smoother.
Keep the queue compact so you can react faster to the live moment and viewer requests. Short queues are more flexible and reduce overload.
Prepare playlists for pre‑show, breaks, and format switches. This keeps transitions smooth and holds stability if unexpected pauses happen.
Before going live, verify your OBS sources—check audio, autoplay, and correct links. It saves time and prevents on‑air issues.
Watch connection indicators. If needed, rotate tokens or refresh sources—this takes seconds and can save a stream. If something breaks, History helps you restore flow quickly.
- Keep a short queue to stay flexible on air.
- Use playlists for pre-show and intermission sets.
- Test OBS sources before going live (audio + autoplay).
- Check the connection indicators; offline means OBS is not open.
- Rotate the public token if you shared it widely.
- Use history to recover fast after a refresh.
Troubleshooting
Quick fixes for common issues.
No audio in OBS? Make sure Control Audio via OBS is enabled and the source isn’t muted. Then check levels in the audio mixer.
Video won’t start? Refresh the Browser Source or the whole scene. Also check that Refresh browser when scene becomes active is enabled—it usually fixes it.
Overlay is empty or transparent? Verify the token and URLs. If the queue is empty, the player becomes transparent—this is expected.
Search or AI suggestions don’t work? It’s usually the API key or an exhausted quota. Check your YouTube API key status and remaining limit in Google Cloud, then retry.
- No sound in OBS: enable Control Audio via OBS and unmute the source.
- Video not starting: refresh the source or scene once.
- Overlay empty: verify you're using the right token link.
- Search/AI errors: check API key validity and quota.
- Donations not added: ensure the integration is connected and enabled.
- Player offline: open the player link in OBS and wait a few seconds.
- Not syncing: reload the dashboard or refresh OBS sources.
FAQ
Detailed answers about queue, OBS, donations, quotas, and integrations.
The short answers
What do I need to install?
Nothing. Driler FM is a web app: create an account, copy the player link and paste it into a Browser source. No plugins, no OBS extensions.
Does it work outside OBS?
Yes. Any software with a Browser source will do — OBS Studio, Streamlabs, XSplit and others.
What's free and what's Pro?
The queue, player, overlays, search with your own key, one playlist and 1 overlay theme are free. Pro lifts the playlist limit and unlocks AI picks, DonationAlerts, Donatty, the YouTube chat bot and 9 more overlay themes.
Why do I need my own YouTube API key?
Search runs through the YouTube Data API, and every key has a daily quota. Your own key means your own quota, not one shared with other streamers. It takes a couple of minutes to add in settings.
What is Driler FM and why are there two public links?
Driler FM is a private queue dashboard. /en/player is the OBS player, /en/queue is the upcoming tracks overlay. Both links are view-only.
Where do I get the links and how do I rotate them?
Copy them in Settings → OBS Links. If a link is exposed, rotate the token—old URLs stop working immediately and new ones appear automatically.
Why is the overlay empty or transparent?
Check the token and make sure the queue isn’t empty. When the queue ends, the player turns transparent—this is expected behavior.
What do the connection indicators in On Air mean?
They show whether the player and queue are open in OBS or a browser. Without an active player, some controls are unavailable.
Why is Play/Pause disabled?
You need an active track and a connected player. Open the player link in OBS and wait a few seconds.
How do DonationAlerts and Donatty donations work?
Connect integrations in Settings. If a donation message includes a YouTube link, it’s added to the queue without interrupting playback. Donatty requires Pro and a widget URL.
How do I set donation priority manually?
Click the star on a track—it becomes a donation and stays above regular tracks by time of addition.
Why isn’t a duplicate added?
If duplicate blocking is enabled, the same video won’t be added from the input field, playlists, or donations.
Where do titles come from and what if it’s blank?
Titles are fetched from YouTube. If data is missing, the videoId is shown—try again later.
Search doesn’t work—why?
You need a valid YouTube Data API key and remaining daily quota. When the quota is exhausted, search pauses temporarily.
AI suggestions don’t work—why?
You need Pro and a valid YouTube key. There are also prompt length limits and rate limits—try a shorter request.
Append vs Replace when adding a playlist?
Append adds the playlist to the end of the current queue. Replace clears the queue first and then loads the playlist.
What’s stored in History and Stats?
History holds played and removed tracks with a one‑click requeue option. Stats shows totals, weekly activity, and top tracks for the selected period.
Can I share public links?
Yes—these are view‑only links with no login. To revoke access, rotate the token.
How do I get audio in OBS?
Enable Control Audio via OBS or unmute the Browser Source and check the mixer.
Video doesn’t start in OBS—what should I do?
Refresh the Browser Source or the scene and enable Refresh browser when scene becomes active.
What does YouTube Chat do?
It posts the current track to chat when playback starts. It’s a Pro feature connected in Settings.
Why did another window override my action?
The most recent command takes priority. For a live show, use one main tab.
Why didn’t a donation add a track?
Check that the integration is connected and enabled, the message includes a full YouTube URL, and duplicate blocking didn’t reject it. Donatty requires a standard widget.
How do I connect Donatty?
Create a standard Donatty donation widget, copy its URL, paste it in Settings → Donatty, then connect and enable it.
Can I pause donations without disconnecting?
Yes. Turn off the donations toggle in Settings—the connection stays, but new tracks won’t be added.
Where can I see donation status?
Settings shows the connection status (connected/reconnecting), whether it’s enabled, and the time of the last donation.