# Radio Scanners

{% hint style="warning" %} Due to bandwidth usage, this feature is automatically enabled with the Pro version only! [Learn more about our paid subscription plans.](https://docs.sonoransoftware.com/radio/pricing/pricing-faq/standalone-pricing) {% endhint %} ## Video Example ## Using the Radio Scanner ### Enabling the Scanner 1. Enable the `config.chatter` option in your [config.lua](https://docs.sonoransoftware.com/radio/getting-started/installing-the-in-game-resource#updates). 2. Add the `sonoranradio.scanner` [ace permission](https://docs.sonoransoftware.com/radio/tutorials/usage/in-game-radio/configuring-ace-permissions). ### Opening in Standalone You can use `/radio scanner` command to open a personal scanner. This requires the `sonoranradio.scanner` [ace permission](https://docs.sonoransoftware.com/radio/tutorials/usage/in-game-radio/configuring-ace-permissions). ### Opening in a Framework Server (QBCore, Qbox, etc.) With the radio scanner item in their inventory, users can double click to open the [scanner menu](#using-the-radio-scanner-1). [View our complete list of supported FiveM frameworks an inventories.](https://docs.sonoransoftware.com/radio/tutorials/integrations/fivem-inventories)

#### Item Drop {% hint style="warning" %} Dropping scanners is not currently supported in OX inventory. Support will be added at a later date, pending more information from the OX development team. {% endhint %} If the scanner item is dropped on the floor, you can open its scanner menu by being near it and pressing `E`. If the scanner is powered, transmissions will be heard by nearby users.

Sonoran Radio Scanner Item Drop Use Hint

### Radio Scanner Menu

Press the power button and the scanner will auto-connect to the default channel. Use the knob to scroll through all available channels. By default, only public radio channels will be available. For [private channels](https://docs.sonoransoftware.com/radio/tutorials/dispatch-panel/configure-channels#restrict-channel-visibility), you can [configure ACE permissions to access them](#ace-permissions). ## Permanent Scanners Permanent Scanners are scanners that are available to everybody at configurable locations across the map. For example, you can add a scanner in the Sandy Shores Sheriff Station that will always listen the `County Patrol Ops` channel. #### Configuring Permanent Scanners You can use `/radiomenu` to easily add, move, or delete persistent scanners

When creating a scanner, you have the ability to choose between many different scanner-like models to best fit your needs

You can also modify the `scanners.json` JSON config file for more customization. By default, scanners connect to the default channel, but you can customize the channel ID it uses.

Example Scanner JSON

```json { "Id": "036a2ad1-eeae-4519-be4c-67157b8a035d", "Note": "Sandy Sheriff Station", "Powered": true, "ChannelId": 31226, "PropModel": "prop_cs_hand_radio", "PropPosition": { "x": 1853.98, "y": 3688.92, "z": 34.38054, "heading": 32.76, "exact": false } } ```

#### Finding Channel IDs The channel IDs can be found in the [dispatcher panel](https://docs.sonoransoftware.com/radio/tutorials/dispatch-panel/using-the-dispatch-panel#channel-ids) or [in-game radio](https://docs.sonoransoftware.com/radio/tutorials/usage/using-the-in-game-radio/fivem-keybinds-and-commands#copying-channel-and-scan-list-ids). ## Developers ### Ace Permissions If you have enabled `Config.acePermsForScanners`, you must add permissions in your `server.cfg`for the scanner to work. The channel IDs can be found in the [dispatcher panel](https://docs.sonoransoftware.com/radio/tutorials/dispatch-panel/using-the-dispatch-panel#channel-ids) or [in-game radio](https://docs.sonoransoftware.com/radio/tutorials/usage/using-the-in-game-radio/fivem-keybinds-and-commands#copying-channel-and-scan-list-ids). ```bash # Give the group access to /radio scanner add_ace group.admin sonoranradio.scanner allow # Only public (non-private) channels are accessible # Grant access to a private channel with the ID of 123 add_ace group.admin sonoranradio.channel.123 allow ``` ### Giving the Scanner Item (QBCore) Sonoran Radio does not provide a way to get the scanner item independently. You can give the item with any method, but here's an example chat command: ``` /giveitem sonoran_radio_scanner 1 ``` Please note that if you changed `Config.ScannerItem.name`, it will not work with `sonoran_radio_scanner`