Phone
Configuration
Custom ringtones and notifications

Custom ringtones and app-specific notifications

The phone supports two different sound systems, NUI (2D, not synced between players) and native GTA audio (3D, synced between players). This can be changed in lb-phone/config/config.lua, by changing Config.Sound.System.

Native GTA audio

Before generating the audio files for native audio, you need to install the latest release of lb-nativeaudio (opens in a new tab) and CodeWalker (opens in a new tab).

Custom ringtones

Add audio files

If you're using the NUI sound system, add the ringtone audio files to the lb-phone/ui/dist/assets/sound/ringtones folder. The files have to be in the .mp3 format.

If you're using the native GTA audio system, follow the guide in the README file included in lb-nativeaudio (opens in a new tab) to generate the sound files, and replace the files in the lb-phone/sound/ folder.

Update the config

After having added the audio files, you need to update the lb-phone/config/config.lua file. Add the new ringtones to the Config.Sound.Ringtones table:

lb-phone/config/config.lua
Config.Sound.Ringtones = {
	-- ... previous ringtones
	["Ringtone Name"] = {
		name = "1", -- the name of the ringtone file, without extension
		soundSet = "ringtone", -- the soundset to use, the default is "ringtone"
	}
}

Restart the phone

After adding the audio files and updating the config, you need to restart the phone for the changes to take effect.

Custom notifications

Add audio files

If you're using the NUI sound system, add the notification audio files to the lb-phone/ui/dist/assets/sound/notifications folder. The files have to be in the .mp3 format.

If you're using the native GTA audio system, follow the guide in the README file included in lb-nativeaudio (opens in a new tab) to generate the sound files, and replace the files in the lb-phone/sound/ folder.

Update the config

After having added the audio files, you need to update the lb-phone/config/config.lua file. Add the new notifications to the Config.Sound.Notifications table:

lb-phone/config/config.lua
Config.Sound.Notifications = {
	-- ... previous notifications
	["Notification Name"] = {
		name = "1", -- the name of the notification file, without extension
		soundSet = "notification", -- the soundset to use, the default is "notification"
	}
}

Restart the phone

After adding the audio files and updating the config, you need to restart the phone for the changes to take effect.

MusicApps