Skip to content
Plugin guide

The advanced guide to MRK Media Suite

Put your photos, live guest texts, karaoke queue, adverts, overlays and messages on screen from inside Virtual DJ. This guide covers v4.0.14 on Windows, from install to running a full night.

Virtual DJ video plugin Windows 15 panel types Beat-synced slideshow Live texts Karaoke

At a glance

Nine pages, one key each. Press 1–9 in the plugin window to jump straight to a page.

How the screen stacks up

Adverts cover everything; your panels sit above the deck video. If something is hidden on the output, check what sits above it.

On top

Adverts

Play over everything below, including messages and the deck video.

Layer 3

Messages and countdown

Above your panels and slideshow, unless placed in a DJ Messages or Countdown panel.

Layer 2

Your layout panels

Texts, karaoke queue, clock, overlays, images… stacked by Layer order (Up / Down).

Bottom

Main panel

Virtual DJ deck video, or the slideshow. Move it Up to put it in front of panels.

1

Install and first launch

Setup takes about two minutes. The plugin and its interface always install together.

  1. Run MRK-MediaSuite-Setup-<version>.exe. If Windows SmartScreen shows "Unknown publisher", click More info → Run anyway. The installer isn't code-signed yet.
  2. Keep the recommended folder: %LOCALAPPDATA%\VirtualDJ\Plugins64\VideoEffect.
  3. Tick the optional shader pack for 83 extra Virtual DJ visualisations. The 27 built-in shader effects come with the plugin either way.
  4. Let it add Microsoft WebView2 if asked. It only does this when your PC doesn't have it.
  5. Open Virtual DJ, go to the Video effects list, pick MRK - Media Suite Virtual DJ plugin and switch it on.
  6. Open the plugin window from the effect's settings button.

Important: nothing the plugin draws appears on the video output until you've opened the plugin window once after loading the effect. Your deck video still plays through as normal.

Plugin not showing in the Video effects list? The most common reason is that your Virtual DJ is still using the Documents folder for its files and database, not AppData.

Back in 2017–2018, Virtual DJ kept everything in Documents\VirtualDJ. It later moved to %LOCALAPPDATA%\VirtualDJ (the AppData folder), but only for fresh installs. If your Virtual DJ was first installed back then, it keeps using the Documents folder even after updating, so it never looks in the AppData folder the installer uses by default.

To check: look in Documents\VirtualDJ. If you see database.xml and settings.xml there, that's the folder your Virtual DJ is using.

To fix: run the installer again and change the folder to Documents\VirtualDJ\Plugins64\VideoEffect, then restart Virtual DJ.

Your own files live in Documents\VirtualDJ\Mrk Plugins\Media-Suite (lyrics, shaders, thumbnails, styles). Back this folder up before a big gig.

2

Getting around the plugin window

Everything sits in one window: pages down the left, the page in the middle, live controls along the bottom.

The plugin window on the Layout page
The plugin window, here on the Layout page with the Neon Club theme
AreaWhat's there
HeaderVersion, theme picker (16 themes, including four light ones for daylight gigs) and your licence badge
Left menuThe nine pages. Press 1–9 to switch
Bottom live barQuick message box with ★ favourites, Show / Hide, the next karaoke singer with Next singer ▶, ▶ Advert, and the track playing now

Tip: right-click almost everything. Panels, media slots, layout tabs, vaults and the empty canvas all have menus, with shortcut keys shown on the right.

3

Layouts: building your screen

A layout is the set of panels drawn over your video. Keep up to 32 layout tabs and swap between them live, for example Arrival, Party, Karaoke and First dance.

Step 1Edit one tab while another is live

  1. The tab with the green ACTIVE badge is what's on screen now.
  2. Click any other tab to edit it. The screen doesn't change, and your edits save to that tab as you go.
  3. When it's ready, press Activate <tab name>, or right-click the tab and choose ▶ Activate (put on screen).

Step 2Manage tabs from the right-click menu

Right-click menu on a layout tab
Right-click a layout tab
  • Duplicate tab makes "<name> copy" and opens it for editing.
  • Copy current layout here overwrites the tab with what you have open (it asks first).
  • Rename…, Clear tab (removes every panel, keeps the tab) and Remove tab. You can't remove the live tab or the last tab.

Step 3Add panels

Press a button under Add Panel. There are 15 panel types:

MainThe Virtual DJ deck video
ImageA picture or animated GIF that can spin, rock or pulse to the beat
Text / Text 2Your own words, with fonts, animation and effects
ShaderAny built-in or Virtual DJ shader, with chroma key
Now PlayingThe current track, still or scrolling
▶ VideoA video file, with chroma key
♫ LyricsSynced lyrics for the master deck
💬 TextsIncoming guest texts (section 6)
🎤 Karaoke queueThe "Next up" card and banner (section 8)
🕐 Clock35 clock styles
⏱ CountdownThe Messages countdown, 26 styles
▶ OverlayThe current Overlays item (section 10)
🖼 Slide ShowThe slideshow in a box instead of full screen
📣 DJ MessagesYour messages, wrapped and fitted to the box

Step 4Place panels precisely

Right-click menu on a panel
Right-click a panel for Position, Rotate, Layer order and Frame
  • Drag to move, drag a corner to resize, drag the round handle to rotate. Hold Shift for 15° steps, or press [ and ].
  • Arrow keys nudge 1 px; Shift + arrows nudge 10 px.
  • Pick snapping from the menu above the canvas (guides, or a grid up to 64×64). S turns snapping on and off; hold Alt to move freely.
  • Panels on top of each other: click again to pick the one underneath, or right-click → Panels under the pointer.
  • Right-click → Position for one-click Full screen, Centre, Lower third, Top bar and Corner logo.
  • Layer order (▲ Up / ▼ Down) also moves the Main deck video in front of or behind other panels.
  • Ctrl+D duplicates, Ctrl+C / Ctrl+V copy and paste (also between tabs), Del deletes.
  • Press 💾 Save when you're happy.
4

Panel settings in depth

Double-click a panel, or select it and press Edit Panel…. The Visible switch and size sit at the top; below are tabs for Content (named after the panel, such as Queue, Video or Lyrics), Text style on text panels, Position and Frame.

Karaoke queue panel settings
Settings: the Queue tab
Frame tab with Quick looks
Settings: the Frame tab with Quick looks

FramesFrames and backgrounds

  1. Open the Frame tab and click a Quick look: Gold, Neon, Marquee, Film, Wedding, Christmas, Polaroid, Disco, Equaliser and more.
  2. Or build your own from 27 frames (Neon glow, Marquee lights, Rainbow, Equaliser bars that move to the beat…) and 21 backgrounds (gradients, polka dots, bokeh, tartan, sunburst…).
  3. Fine-tune thickness, two colours, rounded corners, pattern size, opacity and animation (pulse to the beat, or colour cycle).

Frames sit outside the panel so they never cover what's in it, and they turn with rotated panels.

KeyChroma key (Video and Shader panels)

Remove green, black, blue or white, Remove a colour (any colour you pick), or use Soft brightness key. Each panel has its own Tolerance, Edge softness and Remove colour spill.

Tip: for clean logos and stings, use .mov files with a transparent background. PNG-codec .mov keeps the transparency; ProRes 4444 may not play.

LyricsLyrics panel

Lyrics follow the master deck. The plugin checks, in order: Virtual DJ's own lyrics, a .lrc file next to the song, lyrics inside the MP3, then LRCLIB.net online. Press 🔎 Find lyrics… to choose the right ones (your choice always wins), or Turn off for this song. Lyrics hide on karaoke tracks.

ClockClock and Countdown panels

Open the Style menu for a searchable live preview, grouped into Digital, Analog, Text, Retro & Party, Data and Compact. Clocks show 24h, 24h with seconds or 12h, with an optional date or day name.

5

Media Vault and the slideshow

Each Media Vault holds up to 200 photos and videos, and the slideshow can change slides on the beat. The free version has 1 vault and 5 slots.

The Media page
The Media page: vaults across the top, slots in the middle, slideshow settings on the right

Step 1Load your media

  1. Open Media and pick a vault from the coloured bar at the top.
  2. Right-click a vault to rename it or change its colour (e.g. "Wedding photos").
  3. Right-click an empty slot to load a file, or right-click a filled slot and choose Replace…. Drag slots onto another vault to move them.

Step 2Fine-tune each slide

Slide settings for one slot
Right-click a slot → 🖼 Slide settings…
  • Turn 90°, Mirror or Flip.
  • Choose How it fits the screen and what goes Around the picture (black, a blurred copy, or see-through).
  • Click the preview to set a focus point for cropping. Centre focus resets it.
  • For green-screen or black-background clips, right-click the slot → Remove green screen or Remove black background, then set the Green / black key strength slider.

Step 3Set the playback

SettingChoices
Time to transitionSeconds per slide
Change slidesBy time, every 1, 2, 4, 8, 16 or 32 beats, every bass hit, or With the energy (faster when it's busy, on the drop)
Pulse on the beatOff, Subtle, Strong, With the bass
TransitionCut, Fade, Crossfade
DirectionForward, Backward, Random
ExtrasLoop, Play videos to the end

Press ▶ Start. Stop Output clears the screen.

Tip: beat sync follows the song playing in Virtual DJ. With nothing playing, slides change on the seconds setting.

Advanced: add a 🖼 Slide Show panel in Layout to play the slideshow in a framed box, such as a photo wall beside the deck video. With no Slide Show panel it plays full screen in Main.

6

Text to Screen (Pushbullet)

Guests text your number and their messages, emojis and pictures appear on screen. You decide whether they go up straight away or wait for your OK.

Text to Screen set up with Pushbullet
Text to Screen, connected through Pushbullet

Step 1Connect Pushbullet

  1. Install Pushbullet on your Android phone and turn on SMS sync.
  2. On pushbullet.com go to Settings → Account → Create Access Token.
  3. In the plugin, open Text to Screen and set the service to Pushbullet. Paste the Access token, plus your end-to-end encryption password if you use one.
  4. Press Save & test, then pick your phone under Phone that syncs your texts (press Refresh if it's missing).
  5. Tick On at the top.

Good to know: the token is kept in Windows Credential Manager, never in a settings file. Pushbullet's free plan syncs 100 texts a month.

Step 2Control what reaches the screen

SettingRecommended for a wedding
The number people text + promptTick Show the number on screen with "Text your shout-outs to"
When a text arrivesHold it until I approve
Keep each text up for30 seconds
Texts on screen at once3
When it's quiet, replay texts fromThe last 6 hours, one every 15 seconds
Don't show texts containingYour blocked words, comma-separated. End one with * to catch every word starting with it
Show who it's fromOn (the middle of the number is hidden)
Hide texts while karaoke playsOn

Approve, hide or delete texts from the Texts received list at the bottom of the page.

Step 3Design the look

How texts look: style, colours, animations
How texts look: style, colour, side, animations and auto-scroll
  1. Style: 50+ looks, from Phone bubbles, Neon glow and Wedding (ivory & gold) to compact List, Wireframe, Glass, Gold and Neon lists, plus anything under Your styles (section 12).
  2. Colour: iMessage blue, WhatsApp green, dark, your accent, pink, purple, gold or party. Then choose Which side.
  3. Where texts appear: in a 💬 Texts panel (or a corner/banner when there isn't one), or only in a Texts panel.
  4. Animations: 17 ways in (including 3D fly-in, swing and slam), 13 ways out, three speeds, and Older texts glide up smoothly.
  5. Auto-scroll: a News ticker bar, or a Rolling feed.
  6. In the Texts panel's own settings, set Text size, Prompt size (50–250 %) and font.

Step 4Rehearse with Demo chat

Turn Demo chat on and add up to 20 pretend texts. They go through the word filter and approval like real ones but never touch Pushbullet, so you can try every style on the real screen before the gig. Test on screen sends a single one.

7

Messages and the countdown

Keep a list of ready-made announcements and put any of them up in one click, plus a countdown to midnight or any time you choose.

The Messages page
The Messages page with three saved messages, two of them favourites

MessagesYour announcements

  1. Type in Add a message, choose how long it stays up, then press Add to list or Add & show. Enter adds it to the list.
  2. Star up to 10 as ★ favourites. They appear in the ★ quick-pick on the bottom bar for one-tap use.
  3. Each message can have its own display time. The status line shows "ON SCREEN · 0:32 left" while it's up.
  4. Under Look, set the position (Top, Middle, Bottom), size and border colour. Quick message look sets the font, size, colour and an optional "from the DJ" label.

Tip: add a 📣 DJ Messages panel in Layout to put messages exactly where you want them. Without one, the Top / Middle / Bottom position is used.

CountdownCount down to midnight

  1. Set the Heading (e.g. "Midnight in") and the time to Count down to.
  2. Set what to show at zero (e.g. "HAPPY NEW YEAR!") and for how long.
  3. Press ▶ Start countdown. The last 10 seconds show as big numbers.

It counts to the next time the clock reads that time, so 00:00 started at 9 pm means tonight's midnight. Add a ⏱ Countdown panel to use one of 26 styles instead of the full-screen version.

8

Karaoke queue

Show singers who's up next. The queue can read Virtual DJ's own karaoke list live, so there's nothing to type twice.

The Karaoke page reading Virtual DJ's list
The Karaoke page reading four singers from Virtual DJ's karaoke list
  1. Singer list: choose VirtualDJ's Karaoke list (Sideview → Karaoke; set each singer's name with the gear icon under the Singer field), or Only MRK Media Suite's own list and add name + song with + Add.
  2. Show the queue on screen: a "Next up" card between karaoke songs, or the card plus a small banner during karaoke.
  3. Tick Move to the next singer when a new karaoke track starts for hands-free running, or press Next singer ▶ (also on the bottom bar).
  4. Add a 🎤 Karaoke queue panel in Layout. In its settings choose a Style, the Text size and font.
  5. In Options, tick Auto-hide panels/slideshow on karaoke and Disable shaders on karaoke so the lyrics stay readable.

The queue panel has 30 compact list looks, from plain lists to wireframe, glass, neon and gold, plus your own (section 12):

The 30 built-in karaoke queue list styles
The 30 built-in karaoke queue list styles
9

Adverts

Adverts play your promos on a timer, on top of everything else on screen.

The Adverts page
The Adverts page with three adverts, one using green-screen removal
  1. Press + Add advert… and pick a video or picture. For each one set how long it shows and whether to remove a green screen or black background.
  2. Set Show an advert every (minutes or seconds) and tick Play adverts.
  3. Tick Hold adverts during karaoke: an advert that's due waits until the song ends.
  4. Dim the screen behind adverts: Always, or only when singers are waiting. Set the dim amount.
  5. To play one right now, press ▶ Advert on the bottom bar, or ▶ Play on its row.

Note: adverts cover the slideshow, your panels, messages and the Virtual DJ video. They play without sound.

10

Overlays

Overlays rotate party graphics, transparent .mov stings and GIFs inside an ▶ Overlay panel. With no Overlay panel in the live layout, nothing plays.

Happy 40th Birthday overlay
Example: a party overlay
Karaoke overlay pack preview
Example: karaoke overlays

Step 1Build groups

Overlay groups with their items
Two groups: Birthday (rotating) and Bar (with its own settings)
  1. Press + Add group (up to 10 groups of 20 items) and give it a name, e.g. "Birthday".
  2. Press + Add files… and pick pictures, videos or GIFs.
  3. For each item set its show time and transparency, tick it on or off, and use ▲▼ to order it.
  4. Untick a group to rest it. Tick Use its own settings to give a group its own timing.

Step 2Set the playback

  • Play: Always rotating, or Every X minutes. Rotating groups take turns; a timed group cuts in when it's due, then hands back.
  • Order inside each group: in order, or Random (no repeat until all played).
  • Transition: Cut, Fade or Slide. Tick Hold during karaoke.
  • Live controls: Now showing, ⏭ Next and ❚❚ Pause.

Example: a "Birthday" group rotating in a corner panel all night, plus a "Bar" group with Last Orders set to every 20 minutes.

11

Shader Studio

Describe an animated visual in plain words and Shader Studio writes, compiles and previews it for you.

Shader Studio
Shader Studio: describe it, preview it, tweak it, save it
  1. Under Claude settings, paste an Anthropic API key from console.anthropic.com and press Save. Choose a model; Sonnet is recommended and costs roughly a few pence per shader.
  2. Describe the visual, e.g. "gold glitter raining down that bursts outwards on every kick". Choose Premium neon or Standard and press ✨ Make it.
  3. Watch it in Preview. Tick Demo beat if no music is playing. The plugin must be switched on in Virtual DJ's video for the preview to run.
  4. Refine it with Tweak it or a one-click chip: Faster, Slower, More colourful, React more to the bass, Make it lighter to run… A ⚠ warning appears if it may stutter full screen.
  5. Name it and press Save to VirtualDJ. It's then available in Shader panels and as the Main shader.

Good to know: your API key is kept in Windows Credential Manager. Track spending under Credits left.

12

Your own list styles (Style maker)

Make your own look for the Karaoke queue and Text to Screen lists, save it as a small style file, and share it with other DJs.

The Style maker with live mock-ups
The Style maker, with live mock-ups of both lists on the right
  1. Press 🎨 Style maker… on the Text to Screen page, or in the Karaoke queue panel's settings.
  2. Start from the After Hours template, one of your styles, or any built-in list look.
  3. Set the Layout, Behind the list, Each entry, Number / initial badge and Corners, then the font, effect, CAPITAL LETTERS, the two queue headings and up to ten colours. Untick a colour to follow the panel's colour.
  4. Choose Show it in: both lists, Karaoke only or Texts only. The mock-ups update as you go.
  5. Press Save & use.

ShareSharing styles

  • Style files live in Documents\VirtualDJ\Mrk Plugins\Media-Suite\styles. 📂 Styles folder opens it.
  • Import .css… loads a style someone sent you. Copy copies yours to paste into a message.
  • Edit a style file and the screen updates within about 2 seconds, no restart needed.
  • MRK Template - After Hours.css in that folder explains every setting.

Note: if a layout uses a style file that's missing on another PC, the list shows Glass list instead.

13

Options, licence and updates

The Options page
The Options page, signed in and licensed
CardWhat to set
PlaybackScale Mode (Aspect Fit, Fill, Stretch, No Scale) and Render Mode (Auto, CPU, GPU). Try CPU if a laptop struggles
ShadersTurn shaders on, choose the Main shader with ✨ Browse…, Reload Shaders after adding new ones, Disable shaders on karaoke
KaraokeAuto-hide panels/slideshow on karaoke
UpdatesShows your version and last check. Check for updates checks now
LicenceSign in, Activate Device, Validate, Logout

LicenceActivate your licence

  1. Under Licence, sign in with the email and password of your account on this site.
  2. Tick Keep me signed in on this PC, then press Activate Device. The badge turns green: Licensed.
  3. Moving to a new laptop? Press Logout on the old one first to free the device. You can also see your devices in My licences.

UpdatesStaying up to date

The plugin checks this site shortly after it loads, then once a day. When there's a new version, a banner offers Download from website, Remind me later or Skip this version. Updates are included while your subscription is active, or with a lifetime licence.

14

Gig-night checklist

A running order for a wedding or party with karaoke. Tick items off as you go; your ticks are remembered in this browser.

SetupAt setup

LiveDuring the night

15

Shortcuts and troubleshooting

KeysKeyboard shortcuts

KeyDoes
1–9Switch page
Arrows / Shift + arrowsNudge the selected panel 1 px / 10 px
[ / ]Rotate the selected panel
Shift while rotating15° steps
SSnapping on / off
Alt (hold)Move freely, no snapping
Ctrl+DDuplicate panel
Ctrl+C / Ctrl+VCopy / paste panel
DelDelete panel
Enter in the message boxAdd to list

HelpTroubleshooting

Open the plugin window once after loading the effect. Check the panel's Visible switch and that the right tab is ACTIVE.
Press Save & test, check your phone is selected and Pushbullet SMS sync is on, and check the 100-a-month free limit.
Where texts appear may be set to "only in a Text to Screen panel" with no Texts panel in the live layout.
Probably an unsupported codec such as ProRes 4444. Re-export as PNG-codec .mov to keep transparency.
Change Render Mode, use a lighter shader, or ask Shader Studio to "make it lighter to run".
Set each singer's name in Virtual DJ's karaoke list so the plugin can skip the current singer.

Still stuck?

Support comes straight from the developer, who uses MRK Media Suite at his own gigs.

Contact support

VirtualDJ is a trademark of Atomix Productions. MRK Media Suite is an independent third-party product and is not affiliated with, endorsed by, or officially connected to VirtualDJ or Atomix Productions. Screenshots show sample names and messages.