Skip to content

Recording ​

Words
480 words
Reading time

MajdataPlay supports two recording modes:

ModePlatformNotes
OBSTriggerDesktop onlyControls OBS recording through the OBS WebSocket, suited to setups that need custom scenes, cameras or overlays
FFmpegDesktop and mobileRecords gameplay video and audio with the built-in FFmpeg and writes to RecordOutputs

Set the recording mode in Common.RecordMode in system-settings.json. The default is "Disable".

Record with the built-in FFmpeg ​

  1. Change Common.RecordMode in system-settings.json to "FFmpeg".
  2. Restart the game. An Encoding menu appears in the settings UI.
  3. In Encoding, set the encoder, frame rate, bitrate and resolution scale; set the container format in Encoding.ContainerFormat in system-settings.json (MP4 by default).
  4. Start playing. Recording starts automatically when the game starts and is saved automatically when you quit the song or the game ends.

The default output is MP4, stored in the RecordOutputs folder under the game data directory, with a file name like SongTitle_Charter_2026-01-01_12_00_00.mp4. If muxing the audio track fails, a video-only .mkv file is kept.

Encoding tips ​

  • On desktop, prefer Hardware; if the picture is corrupted, recording fails or the driver is unsupported, switch to Software.
  • On mobile, keep Hardware and let the system hardware encoder handle it. If the device overheats or drops frames, lower ResolutionScale, FrameRate or BitRate.
  • When RateControlMode is VBR, you can set MaximumBitRate; adjust it yourself if the streaming or upload platform has bitrate limits.
  • Recording consumes GPU, CPU and storage. Check the free space before a long recording.

Mobile ​

Both Android and iOS can use the FFmpeg mode. Output files are stored in RecordOutputs under the app data directory:

  • Android with storage permission granted: Documents/MajdataPlay/RecordOutputs
  • Android without storage permission: Android/data/net.majdata.majdataplay/files/RecordOutputs
  • iOS: RecordOutputs in the MajdataPlay folder

OBSTrigger cannot be used on mobile; that option cannot be selected there.

Record with OBS ​

The OBS mode is desktop only. This feature works by having Xiaoxiao Lanbai press the record key for you, so configure your scene in OBS first and capture MajdataPlay with Display Capture or Game Capture; other capture modes may fail to record.

OBS configuration

  1. Select Tools at the top
  2. Select WebSocket Server Settings from the drop-down menu
  3. Check Enable WebSocket server
  4. Set Server port to 4455 and uncheck Enable authentication

Then set Common.RecordMode to "OBSTrigger" in system-settings.json.

Recording status ​

Once a recording mode is enabled, a camera icon appears below Xiaoxiao Lanbai on the secondary display when you enter gameplay:

  • Not connected: the recorder is not ready yet
  • Connected: the recorder is ready
  • Recording: the current play session is being recorded

TIP

Whether you use OBS or FFmpeg, the recording status icon shows whether the current recorder is connected and whether it is recording.