Studios
Audio Propshouse-3.jpg

Installation

SoonAudio PropsQbox
PAGE 02 OF 07  ·  OVERVIEW → INSTALLATION → CONFIGURATIONdocs.glitchstudios.dev
Browse docs

Requirements#

The server

Framework qbx_core (Qbox). ESX and plain QBCore are not supported.
Resources ox_lib, oxmysql, ox_target, ox_inventory
Admin menu glitch-uiElements, for /audioadmin and the access lists. Placing items works without it, but shows no key hints.
Database MariaDB 10.3 or newer. A fresh MySQL 8 database also works, but upgrades there need columns added by hand.
Optional pma-voice (DJ microphone), sd-phone (Sound & TV app), rpemotes (DJ dance emotes)

Song conversion (optional, off by default)

yt-dlp In bin/: yt-dlp.exe on Windows, yt-dlp on Linux.
Storage A Cloudflare R2 bucket with a public address and a CORS rule for GET and HEAD.
Server permission add_unsafe_child_process_permission glitch-audioProps in server.cfg.
ffmpeg Only for 720p TV video downloads; without it they download at 360p.

Installation steps#

  1. Put glitch-audioProps and glitch-uiElements in your resources folder.

  2. Add the items from install/items.lua to ox_inventory/data/items.lua, and copy install/images/*.png to ox_inventory/web/images.

  3. Optionally run install/install.sql. The tables are also created on first start.

  4. Add to server.cfg, after ox_lib, oxmysql, ox_target, ox_inventory and qbx_core:

    ensure glitch-uiElements
    ensure glitch-audioProps
    add_ace group.admin command.audioadmin allow
    
  5. Restart the server and run /audioadmin in the city to place your first booth, speakers or zone.

[!NOTE] tv_flat and radio_modern have no icon in install/images. Use your own PNG with the item's name.

Commands#

Command Who What
/audioadmin Config.AdminAce Create and edit systems, see placed items, manage the library and TV channels
/stereo Driver Open the car stereo
/streamermode Everyone Mute this resource for yourself (off, half, bass only, mute) and pick your show quality

Updating#

Replace everything except config.site.lua, server/r2.json and bin/, then restart the resource. Database changes apply themselves.