Skip to content
Samuels-DevelopmentPublic

About

A open-source phone project for FiveM.

Resources

Code of conduct

Contributing

Stars

169 stars

Watchers

4 watching

Forks

Repository files navigation

sd-phone

sd-phone banner showing the Home screen in front of a wall of app screens

▶ Video demo

Browser demo

Open the live demo

The phone and tablet UIs run here with sample data. Unlock the phone, move apps around, install apps, open the police terminal or use fullscreen. Nothing to install.

fivem.samueldev.shop/phone


sd-phone is a FiveM phone for QBOX, QBCORE, ESX, ox_core and ND. It includes calls, messages, mail, maps, banking, photos, social apps and games. Apps use server data and their own accounts where needed. The camera shows the game world. Phone props come in eight colours and match the on-screen frame. Unique phones and SIM cards are optional; each phone item can keep its own number and data.

Scripts and custom apps written for lb-phone, qs-smartphone, gksphone, roadphone or YSeries can keep using their old exports and events. For lb-phone and YSeries, the import can bring over numbers, chats, photos, wallet history, social logins and more.

Release Downloads Stars Discord Documentation

Framework Voice Compatibility

Live demo · Documentation · Store · Discord

Works together: sd-phone · sd-tablet · sd-computers


Support Me

If you're enjoying sd-phone and want to support my work, consider picking up a script from Samuel's Development. Every purchase helps me keep building and improving resources like sd-phone. Browse Petty Crimes, Advanced Crafting, Horde, Smash Down, and more to find something for your server.

Shop Petty Crimes, Advanced Crafting, Horde, Smash Down, and 16 more products. Use code SDPhone for 20% off your purchase at fivem.samueldev.shop. One-time use.

Use code SDPhone for 20% off your purchase at fivem.samueldev.shop. One-time use.

Screenshots

Captured from the browser demo using sample data. Click an image for the full 1920×1080 version.

Home and Messages

Photogram and Squawk

Maps and Ryde

Wallet and Marketplace

Weather, Health and Services

Maps on the opened fold screen


Important

Coming from lb-phone or YSeries? Bring your players' data across. Nothing imports by itself: open /phoneadmin → Migration to preview what your old database holds, pick what to bring over and watch it run. Numbers, contacts, messages, mail, photos, wallet history and social accounts come across, so players open the phone already signed in. It never overwrites anything and is safe to re-run. Using unique phones? Turn them on before you import. Migration guide

Tip

Want a tablet? sd-tablet runs these same apps on a bigger screen. Same messages, contacts, accounts and wallet, because both devices read one set of player data. No pairing and no sync.

Tip

Got computers? sd-computers puts this phone on every desk in the city. A free desktop for any computer prop. With both running, the phone's mail, texts, notes, contacts and gallery are on the desktop, and Weazel News, the Marketplace and the city's other apps are live websites in its browser. Needs sd-phone v1.0.7 or newer. More below.

Powered by Fivemanage

Fivemanage

Photos, videos and voice notes upload to Fivemanage. A free Media token in configs/server/apikeys.lua is all it needs.

Apps

Every sd-phone app: Communication, Social, Camera and media, World, Games, Job terminals and Utilities, 51 apps in all

Communication Phone (1:1, group and company calls over pma-voice), Messages (SMS, group threads, GIFs, money and location cards), Mail (multi-account, global inboxes), Groups, Dark Chat, Radio, Find Friends
Social Photogram (posts, stories, DMs, real live video streaming), Squawk, Cherry, Clout (short-form video), Streaks, all on a shared accounts engine with registration, sign-in, and password resets delivered in-game
Camera & media Camera (live game view: photos, video with voice capture, selfie mode), Photos, Music (with AirShare library sharing), Voice Memos
World Maps (CDN-streamed tiles, routing, pins), Garages, Homes, Bank, Services (company directory, dispatch messaging, phone multijob), Ryde (player-to-player ride hailing), Racing (race board with an in-game track creator, unlocked by a racing_usb item), Weazel News, Pages, Marketplace, Weather, Stocks
Games Casino (Slots, Roulette, Blackjack, Baccarat, Crash and Texas Hold'em on a shared chip balance), Chess, Connect Four, Battleship and Wordle with online lobbies, plus Cookie, Flappy, Blocks and Climber with server-side leaderboards
Job terminals MDT, EMS and DOJ, job-gated, with records, warrants, reports, a firearms registry, live CCTV, and bodycam and dashcam review. Off by default: set Enabled = true in configs/mdt.lua. Best on the bigger screen of sd-tablet
Utilities Clock (alarms), Calendar, Notes (with sketches), Files (documents with multi-signer signing, sendable as mail attachments), Calculator, Compass, Health (daily stats and a server-wide steps leaderboard), Passwords, ID (identity cards from your character record and licences, showable to a nearby phone), App Store, Settings

Home screen widgets: eleven of them, each in three sizes and placed anywhere: Weather, Clock, Digital Clock, Now Playing, Wallet, Stocks, Contacts, Garage, Activity, Weazel News and Timers & Alarms. Most come in Dark, Light or Glass, which frosts your wallpaper behind the tile.

Highlights

  • Real accounts. Social apps have registration, sign-in and password resets delivered by in-game mail or SMS, and accounts work across characters.
  • A live camera. The Camera shows the game world in real time, clips record your microphone and nearby voices, and Photogram Live streams real video to other phones.
  • Plugged into your server. Garages and Homes work with 14 garage and 12 housing systems, Wallet reads your framework's bank, and Services turns jobs into companies players can call and message.
  • Custom apps. One export turns any web page into an installable app, and apps built for lb-phone run unmodified. Start from the app templates and the custom app guide.
  • Drop-in compatible. Scripts written for lb-phone, qs-smartphone, gksphone, roadphone or YSeries keep working: their exports are answered and their events mirrored. Details

For developers: server exports, client exports, events, custom apps and lb-phone compatibility are all documented.

Works with sd-computers

sd-computers: Computers for FiveM, a full desktop on any computer in the city

sd-computers Try it in the browser

With both running, a computer becomes another screen for the character's phone: its mail, Messages, Notes, Contacts, gallery and documents, and the city's public apps (Weazel News, the Marketplace, Pages, Squawk, the company directory, the penal code and the stock market) as live websites. Everything goes through the phone's own actions, so it is checked and rate limited exactly as on the phone. Nothing to set up: the link ships with sd-phone v1.0.7 and newer, and set sd_phone_computerlink "off" switches it off.

Compatibility

Layer Supported
Frameworks QBCore, QBox, ESX, ox_core, ND (auto-detected)
Inventories ox_inventory, one_inventory, tgiann-inventory, qb-inventory, qs-inventory(-pro), origen_inventory, codem-inventory, jaksam_inventory, lj-inventory, ps-inventory
Voice pma-voice
Housing 12 housing systems for the Homes app
Garages 14 garage systems for the Garages app, plus ND_Core as the fallback on ND
Notify ox_lib (default), lation_ui (opt-in), framework-native fallback

Installation

Important

Download sd-phone.zip from the latest release, not the green Code button: that is the source, with no built UI, and the phone opens blank.

It needs ox_lib (v3.39.0 or newer), oxmysql and sd-phone-props. Start them first:

ensure ox_lib
ensure oxmysql
ensure sd-phone-props
ensure sd-phone

The database tables create themselves. Then add the eight phone items (phone_black to phone_yellow), your Fivemanage key and, for video calls between different networks, a TURN relay. All of it, step by step: installation docs.

Building from source

Cloned the repo? Build the UI, which lands in the gitignored web/build/:

cd web
npm ci
npm run build

About

A open-source phone project for FiveM.

Resources

Code of conduct

Contributing

Stars

169 stars

Watchers

4 watching

Forks

Releases

Packages

Used by

Contributors

Languages