Read – VDJScript verbs

115 verbs in Read. The verb text stays in English.

• browsed_songset a property of the currently browsed file: "browsed_song 'rating' 5", ...
• browsed_song_hashtagadd or remove a hash tag from user1, user2 or comment of the currently browsed file: "browsed_song_hashtag 'user 1' '#high_energy'"
• get_activedeckget the number of the sync master deck
• get_albumget_album is listed as a VirtualDJ script verb in Read.
• get_armget the position of the turntable arm
• get_artistget_artist is listed as a VirtualDJ script verb in Read.
• get_artist_before_featReturn artist of the track, with 'featuring' stripped
• get_artist_titleget_artist_title is listed as a VirtualDJ script verb in Read.
• get_artist_title_separatorReturn a dash ( - ) if there is both an artist and a title
• get_askthedjReturns the latest request from ask the dj (requires askTheDJMonitoring setting to be on always) Use 'get_askthedj 2' to get the second latest request, etc.
• get_askthedj_unreadReturns the number of unread Ask The DJ requests (requires askTheDJMonitoring setting to be on always)
• get_automixget the position of the automix crossfader
• get_barreturns the current bar number (1 bar = 4 beats)
• get_beatget the intensity of the beat at the current position (0% to 100%).
• get_beat_barget the position in % in the 4:4 bar (or in 4:16 if called with 'get beat_bar 16')
• get_beat_counterget the position of the beat counter
• get_beat_num"get_beat_num" returns a value between 1 and 4 indicating the beat in the measure "get_beat_num 1 4" returns true when the first beat of the measure is currently playing "get_beat_num 1" returns true when the first beat of a 4-beat measure is currently playing (works from 1 to 4) "get_beat_num 16" returns a percentage indicating the beat position in a 16-beat phrase (works with any phrase number larger than 4)
• get_beat2get the intensity of the beats from both decks at the same time.
• get_beatdiffGet the distance between the beat from this deck and the beat from the active deck 50% means the deck are aligned, 0% means this deck is late half a beat, 100% means it is ahead half a beat 'get_beatdiff 4' will return the distance percentage between bars instead of beats
• get_beatgridget the intensity of the beat based on the beatgrid (100% if on the beat, 0% if halfway between to beats).
• get_beatposget the current position in beatgrid coordinate (27.5 would mean halfway between the 27th and 28th beats in the song).
• get_bpmGet the bpm of the song Use 'get_bpm absolute' to get the original bpm of the song (not changing when changing the pitch)
• get_browsed_albumget_browsed_album is listed as a VirtualDJ script verb in Read.
• get_browsed_artistget_browsed_artist is listed as a VirtualDJ script verb in Read.
• get_browsed_artist_titleget_browsed_artist_title is listed as a VirtualDJ script verb in Read.
• get_browsed_bpmget_browsed_bpm is listed as a VirtualDJ script verb in Read.
• get_browsed_color'get_browsed_color 0 red 255' (item, component, default) 'get_browsed_color 0 white' (item, default) returns color for selected item. This includes color filters. (For manually selected color only, use 'get_browsed_song color' instead)
• get_browsed_commentget_browsed_comment is listed as a VirtualDJ script verb in Read.
• get_browsed_composerget_browsed_composer is listed as a VirtualDJ script verb in Read.
• get_browsed_filepathget the filepath of the song currently selected in the browser
• get_browsed_folderget the name of the folder selected in the browser
• get_browsed_folder_iconget_browsed_folder_icon is listed as a VirtualDJ script verb in Read.
• get_browsed_folder_pathget the full path of the folder selected in the browser
• get_browsed_folder_scrollposget_browsed_folder_scrollpos is listed as a VirtualDJ script verb in Read.
• get_browsed_folder_scrollsizeget_browsed_folder_scrollsize is listed as a VirtualDJ script verb in Read.
• get_browsed_folder_selection_index'get_browsed_folder_selection 1 3' returns true if the first line is the selected line in a browser 3 lines high 'get_browsed_folder_selection 3' returns the line number of the selected line in a browser 3 lines high (between 1 and 3)
• get_browsed_folder_tabget_browsed_folder_tab is listed as a VirtualDJ script verb in Read.
• get_browsed_genreget_browsed_genre is listed as a VirtualDJ script verb in Read.
• get_browsed_headerget_browsed_header is listed as a VirtualDJ script verb in Read.
• get_browsed_keyget_browsed_key is listed as a VirtualDJ script verb in Read.
• get_browsed_scrollposget_browsed_scrollpos is listed as a VirtualDJ script verb in Read.
• get_browsed_scrollsizeget_browsed_scrollsize is listed as a VirtualDJ script verb in Read.
• get_browsed_selection_index'get_browsed_selection 1 3' returns true if the first line is the selected line in a browser 3 lines high 'get_browsed_selection 3' returns the line number of the selected line in a browser 3 lines high (between 1 and 3)
• get_browsed_songget a property from the currently browsed file: "get_browsed_song 'title'", "get browsed_song 'playcount'", etc...
• get_browsed_titleget_browsed_title is listed as a VirtualDJ script verb in Read.
• get_browsed_title_artistget_browsed_title_artist is listed as a VirtualDJ script verb in Read.
• get_buildReturns build number
• get_commentget_comment is listed as a VirtualDJ script verb in Read.
• get_composerget_composer is listed as a VirtualDJ script verb in Read.
• get_custom_textget_custom_text is listed as a VirtualDJ script verb in Read.
• get_deckget the number of the deck
• get_deck_analysisget_deck_analysis is listed as a VirtualDJ script verb in Read.
• get_deck_letterget the letter of the deck
• get_decksget the total number of decks of the current skin (can also be used with argument to compare: 'get_decks 4' returns true if 'get_decks' would return 4, false otherwise)
• get_defaultdeckget the number of the default deck
• get_featuring_after_artistReturn featuring artist, stripped from artist or title field
• get_filenameget_filename is listed as a VirtualDJ script verb in Read.
• get_filepathget the filepath of the song on the deck
• get_filesizeget_filesize is listed as a VirtualDJ script verb in Read.
• get_firstbeatget the position of the first beat (in milliseconds)
• get_firstbeat_localget the position of the first beat in the current phrase 16 beats (in milliseconds)
• get_genreget_genre is listed as a VirtualDJ script verb in Read.
• get_hasheadphonesTrue when a headphones output is configured in sound setup, or when the controller has a headphone volume control
• get_hasinputreturns true if the current soundconfig includes any input (mic, linein or timecode)
• get_haslineinreturns true if the current soundconfig includes some linein inputs
• get_hasmasterTrue when a master output is configured in sound setup, false for external mixer configurations
• get_hasmicreturns true if the current soundconfig includes a mic input
• get_hwndreturn the Windows handle to VirtualDJ's window
• get_leftdeckget the number of the left deck
• get_licenseget_license is listed as a VirtualDJ script verb in Read.
• get_loaded_songget a property from the song loaded on the deck: "deck 2 get_loaded_song 'album'"
• get_loaded_song_color'get_loaded_song_color red 255' (component, default color) 'get_loaded_song_color white' (default color) returns color for the loaded track. This includes color filters. (For manually selected color only, use 'get_loaded_song color' instead)
• get_lyrics_languageGet the language of the lyrics loaded on this deck
• get_membershipget_membership is listed as a VirtualDJ script verb in Read.
• get_phrase_num"get_phrase_num" returns a value between 1 and 4 indicating the measure number "get_phrase_num 1" returns true when the first measure of the phrase is currently playing
• get_plugindeckFor use in plugins. Returns 1,2,etc... when plugin is active on a deck, 0 for master, -1 for sampler, -2 for mic
• get_positionget the position in the song
• get_record_messageget the message displayed on the record page
• get_record_minget the minutes of the recording time
• get_record_msget the milliseconds of the recording time
• get_record_msfget the frames of the recording time
• get_record_secget the seconds of the recording time
• get_record_sizeget the current size of the recording file
• get_record_timeget the time already spent recording
• get_remix_after_titleReturn remix of the track loaded on the deck like "(remix)" Remix will automatically be extracted from title if remix field is empty
• get_rightdeckget the number of the right deck
• get_rotationget the angle of the disc
• get_song_eventProvide analysis about current and coming events in the song. Can be used when writing visualisation plugins. The first parameter is "current" or "next" to get the current or the coming event. The second parameter can be "hasbeats", "volume", "volume_end", "remaining"
• get_songlengthget the length in seconds of the song on the deck
• get_spectrum_bandget the level of a single spectrum band. 'get_spectrum_band 1' Use 'deck master' in front to get spectrum of the master deck 'deck master get_spectrum_band 1' By default there are 32 bands, to use a smaller number of bands, use 'get_spectrum_band 1 3' to get the first of 3 bands The third parameter can be used to get a spectrum of stems 'get_spectrum_band 1 32 vocals'
• get_timeget the elapsed time (or remaining or total depending on "display_time"), in milliseconds. Use 'get time 1000' to get another unit than ms (1000=ms, 25=1/25th of seconds, 44100=frames, etc). Use "elapsed", "remain" or "total" to bypass the setting of display_time. Use "absolute" not to take the pitch into account. Use "to_lyrics", "loopin", "loopout", "cue1" etc for time to specific points On texts, use "short" to hide the decimals. Example: get_time "remain" "short"
• get_time_hourGet the hours of the elapsed time (or remaining or total, depending on "display_time") Use 'get_time_hour "absolute"' if you don't want to take the pitch variations into account You can write 'get_time_hour "elapsed"' or "remain" or "total" to bypass the setting of display_time
• get_time_minget the minutes of the elapsed time (or remaining or total, depending on "display_time"). use 'get time_min "absolute"' if you don't want to take the pitch variations in account. you can write 'get time_min "elapsed"' or "remain" or "total" to bypass the setting of display_time
• get_time_msget the 1/100th seconds of the elapsed time (or remaining or total, depending on "display_time") use 'get_time_ms 1000' to get the actual milliseconds
• get_time_msfget the MSF frame of the elapsed time (or remaining or total, depending on "display_time").
• get_time_secget the seconds of the elapsed time (or remaining or total, depending on "display_time").
• get_time_signGet the sign (-1 or +1) of the elapsed time (or remaining or total, depending on "display_time") You can write 'get_time_sign "elapsed"' or "remain" or "total" to bypass the setting of display_time
• get_titleget_title is listed as a VirtualDJ script verb in Read.
• get_title_artistget_title_artist is listed as a VirtualDJ script verb in Read.
• get_title_before_remixReturn title of the track. If remix is empty, the part in brackets in the title is removed (and shown by get_remix_after_title)
• get_title_remixReturn combination of title and remix: "Title (Remix)".
• get_totaltime_minget the minutes of the length of the song
• get_totaltime_msget the 1/100th seconds of the length of the song
• get_totaltime_msfget the frames of the length of the song
• get_totaltime_secget the seconds of the length of the song
• get_usernameget_username is listed as a VirtualDJ script verb in Read.
• get_vdj_folderreturn the home folder of VirtualDJ.
• get_versionReturns version as text such as "2026"
• get_volumeget the volume applied by both the volume sliders and the crossfader
• get_yearget_year is listed as a VirtualDJ script verb in Read.
• has_auxreturns true if the current soundconfig includes a aux input
• has_lyricsCheck if the song loaded on this deck has lyrics
• loaded_songset a property of the currently loaded file: "loaded_song 'rating' 5", ...
• loaded_song_hashtagadd or remove a hash tag from user1, user2 or comment of the currently loaded song: "loaded_song_hashtag 'user 1' '#high_energy'"
• prelisten_infoprelisten_info is listed as a VirtualDJ script verb in Read.

VirtualDJ controllers