Settings
Every setting you can change in BeeBEEP, in the order of the Settings tab, with what it does, its default and what differs on a phone.
For: users · From BeeBEEP 6.0.0 · Updated on
The Settings tab holds everything you can change in BeeBEEP. On a phone there is no Settings tab: open You, and the same entries are listed under your name. This page goes through them entry by entry, in the order they are listed, and says what each control does and what it is set to when you first start. It is for anyone who uses BeeBEEP; what an administrator sets for a whole office is on settings for administrators.

How the Settings tab works
Each entry opens a page of its own. On a phone, or on a window too narrow for two columns, the page covers the list and Back returns to it; on a wide window the page opens beside the list and the entry you are on is lit.
A switch or a choice applies the moment you tap it. Four things wait:
- the network password, which is applied with Apply;
- the language, which changes at the next start;
- the panic log, which takes effect at the next start;
- Prefer IPv6 over IPv4, whose announcement at start follows at the next start.
Some entries exist only on a computer: Audio and Automation, and inside other pages Language and Download folder. General shows a computer's rows on a computer and Android's on Android. Where a default differs between a computer and a phone, the tables say so.
When an administrator has fixed a value for your office, the page shows it greyed, with a shield and a person beside it, and you cannot change it here. Point at the row on a computer, or tap it on a phone, and it says Set by your administrator.; a screen reader reads that with the row. That is the case for your circles and Use circles on public networks too, under Privacy, for Allowed file types, under Preferences, and for the network effort, which reads Custom (managed). What an administrator can fix is on the policy file.
General
How BeeBEEP runs on this device: on a computer, its window and keys; on Android, running in the background. An iPhone or an iPad has none of these, and shows no General.

On a computer:
| Control | What it does | Default |
|---|---|---|
| Closing the window minimizes to the system tray instead of quitting | when on, the window's close button hides BeeBEEP, which keeps running and can be brought back from its icon in the system tray -- on a desktop with no system tray it minimizes the window instead, as the line under the switch says; when off, it quits | on |
| Keyboard shortcuts | opens the page of BeeBEEP's own keys; the row says On or Off | Off |
On Android:
| Control | What it does | Default |
|---|---|---|
| Run in the background | when on, BeeBEEP keeps receiving messages with the screen locked and other apps open, says so in a notification and uses a little more battery; when off, the phone may pause it and messages wait until you open it | on |
Keyboard shortcuts
BeeBEEP's own shortcuts work only once you turn them on. The usual keys of your system, such as the one to quit, always work and are not listed.
| Control | What it does | Default |
|---|---|---|
| Use BeeBEEP's own shortcuts | turns BeeBEEP's keys on or off | off |
| Hide BeeBEEP | the key that hides the window; tap the row, then press the new keys, or Escape to give up | Ctrl+M; Cmd+Shift+H on a Mac |
| Preset messages | the key of your preset messages: in a chat it opens or closes their list above the message field, elsewhere it opens them in Settings; changed the same way | Ctrl+Shift+P; Cmd+Shift+P on a Mac |
A key needs Ctrl, Alt or Meta with another key, and one no other BeeBEEP shortcut has: otherwise the page says Not taken and keeps the old key. Reset appears at the right of a row you changed and brings its default back.
Preferences
What you accept from other people. The three switches are saved as your preferences and your contacts' BeeBEEP knows them.

| Control | What it does | Default |
|---|---|---|
| Join "BEEP" | when off, you are not in BEEP: it leaves your chats, you cannot write to it and nothing is sent to you there | on |
| Accept file transfers | when off, files offered to you are refused and Download automatically is greyed | on |
| Download automatically | the largest file from a contact that downloads without asking; opens its own page, below | 100 MB on a computer, 20 MB on a phone |
| Download folder | where received files go; tap to choose another folder; on a computer only | the system's Downloads folder |
| Use the system Downloads folder | goes back to the system's folder; shown only once you have chosen another one; on a computer only | not shown |
| Accept voice messages | when off, you do not receive voice messages | on |
On a phone the received files stay in BeeBEEP's own documents area, so there is no Download folder row.
Download automatically
A file offered by a contact starts downloading at once when it is not larger than the size you choose here; a larger one waits for you to tap Accept. A file from someone who is not your contact always waits, and a voice message always downloads. A voice message larger than any recording can be arrives as an ordinary file, and waits like one.

| Choice | What it does | Default |
|---|---|---|
| Any size | every file from a contact downloads by itself | no |
| Up to 5 MB | only files up to 5 MB download by themselves | no |
| Up to 20 MB | only files up to 20 MB download by themselves | the choice on a phone |
| Up to 100 MB | only files up to 100 MB download by themselves | the choice on a computer |
| Custom size | a size you type, from 1 to 1048576 MB; applied when you confirm the field | no |
The default is tagged on the page itself. Who counts as a contact is in getting started.
Privacy
Who sees what of you, whose invitations reach you, which networks make contacts and which circles you are in.

Contacts
| Control | What it does | Default |
|---|---|---|
| Profile details | who may fetch your email, phone number, location and the rest of your profile: Only my contacts or Everyone | Only my contacts |
| Who can recognise me over Bluetooth | while BeeBEEP is open, whose phone or computer nearby can tell that you are near, with no connection and no Wi-Fi: Only my contacts, My contacts and group members or Nobody; anyone else only sees that a BeeBEEP device is around, never who. With Nobody, your contacts nearby reach you over Bluetooth only through a search. There is no "Everyone": recognising you needs your key, which only a contact has. Opens its own page | Only my contacts |
| Group invitations only from contacts | when on, an invitation to a group from someone who is not your contact is discarded without being shown; when off it arrives with a warning | off |
| Accept group invitations from contacts | when on, an invitation to a group from one of your contacts is accepted at once and you join without being asked; the chat says that the contact added you to the group. You leave such a group as any other. An invitation to a game is always a question | off |
| Remove contacts not seen for 30 days | removes from your lists the people you have not seen for that many days; the days are counted only when BeeBEEP was used on this device, so a computer used five days a week takes six weeks to count 30. Someone who wrote to you, is in one of your groups, is your contact or is blocked is only hidden: their messages keep their names, and they come back as they were when you see them again. The number is typed under the row; the switch turns it off. Each time someone is removed, a short notice says how many | on, 30 |
| Remove members of new groups not seen for 90 days | the number of days of use each new group starts with for removing the members you have not seen; each group then keeps its own, and its administrators change it in the group's details (see the two rules of a group) | on, 90 |
| Networks | the networks BeeBEEP knows and whether each is private or public; opens its own page, below | the row names the network you are on |
Your name, color and photo are seen by everyone whatever you choose. Everyone is meant for a shop or a reception desk, where anyone on the network may look.
Networks
BeeBEEP asks where you are using it the first time you join a network: at the first start, or the next time you bring its window to the front, one page for each new network ("Network 2 of 3"). Later puts the question off until BeeBEEP starts again; meanwhile the network counts as public and this page shows it Not set. BeeBEEP remembers only the networks you answered. The page lists Connected now the networks this computer is on and Known networks the ones you answered before, each with its category. Tap one to change it.


| Choice | What it does |
|---|---|
| Private | home or office: the people you meet there become your contacts |
| Public | a cafe, a station, a hotel: people you meet there stay as they are, and your contacts see less of you while you are there |
A network still without an answer is shown as Not set. On Windows, a network Windows calls private (or a company's domain network) is private for BeeBEEP too, with no question, and its row says Set by Windows; one Windows calls public is asked like any other. Your choice here wins over Windows', and changes nothing in Windows.
A network with no router -- a cable straight to another computer, or a network whose router is down -- is never asked and is always public: its row says No router: always public. BeeBEEP cannot tell these apart, and calling such a network private would make strangers your contacts. Your contacts stay contacts there.
When people became contacts on a network, its page lists them under Contacts made here and offers Remove them as contacts, which asks you to confirm. People you made contacts yourself stay.
Circles
The Circles card lists your circles. Tap the icon at the right of one to remove it, after a confirmation, and Add a circle to add one: pick a circle heard on your network or type a new name. You see only the people who share a circle with you, and with no circles you see those who have none. Circles says what changes in the lists and the chats.
When your administrator sets your circles the card shows them greyed, each with the administrator's shield, and has nothing to add or remove: see when an administrator sets them.
Notifications

| Control | What it does | Default |
|---|---|---|
| Show notifications | when off, new messages only show in the chat list with their unread count | on |
| Play a sound | BeeBEEP's own beep with each notification, unless the do not disturb of your system is on; it cannot be turned on while notifications are off | on |
| Flash the window | on a computer only: with each notification the button of BeeBEEP in the taskbar flashes (the icon in the Dock bounces on a Mac) while BeeBEEP is not in front, until you open it; it cannot be turned on while notifications are off | on |
A single chat can also be muted with the bell at the top of the chat (on a phone, in Chat options, the button at the right of the header). Either way only the notification of the system is held back, never the unread counts. In a muted group a message that mentions you, or replies to one of your messages, still notifies; with Show notifications off nothing does. An archived chat (Getting started) is held back the same way, and its unread count moves from the tab to Archive. Notifications tells when each one happens.
Audio
Only on a computer.

The microphone and the speaker BeeBEEP uses: for calls, for the voice messages you record and play, and for the ring of a call. One choice serves them all.
| Row | What it does | Default |
|---|---|---|
| Microphone | opens the list of the microphones connected now; the one you tap is used from the next recording or call | System default |
| Speaker | opens the list of the speakers and headphones connected now | System default |
System default follows the device the operating system uses, and changes along with it. On Windows a call and a recording take the device Windows names for communications, as Teams and Skype do; the ring plays on the ordinary default, so you hear it with the headset off.
The Microphone page shows how loud the chosen microphone hears you while it is open: speak and the bar grows. The Speaker page has Play a test sound, one ring on the chosen speaker.
A device you chose and then unplugged stays chosen, shown as "(not connected)": until you plug it in again BeeBEEP uses the system default, then takes it again by itself. To forget it, tap System default.
Appearance

| Control | What it does | Default |
|---|---|---|
| Theme | light or dark; opens its own page, below | Follow the system theme |
| Language | the language of BeeBEEP; opens its own page, below; on a computer only | Follow the system language |
Theme

| Choice | What it does | Default |
|---|---|---|
| Follow the system theme | light or dark, whichever the device is set to, and it switches along with it | the choice |
| Light | always light | no |
| Dark | always dark | no |
The theme changes at once. Whoever wants other colors can edit the theme file: theming says how.
Language
The language changes at the next start: until then the row says Restart BeeBEEP to apply. On a phone BeeBEEP has no language row and uses the language the system sets for it.

| Control | What it does | Default |
|---|---|---|
| Follow the system language | the language the device is set to when BeeBEEP has it, English otherwise | the choice |
| a language | one of the languages BeeBEEP has, each in its own name and in English | no |
| Translations folder | a folder with translation files, such as beebeep_de.qm, used instead of the ones included in BeeBEEP, from the next start | the translations folder of your data folder |
| In use now | which translation is loaded, when there is one to name | -- |
| Open folder | opens the translations folder in your file manager | -- |
| Change... | chooses another translations folder | -- |
| Use the default folder | goes back to the default folder; shown only once you have chosen another one | not shown |
The translations folder is for whoever translates BeeBEEP and wants to try the work: see translating.
Emoji and stickers

| Control | What it does | Default |
|---|---|---|
| Large emoji | a message made only of emoji is shown larger, the fewer the larger; when off, every message is shown at the text's size. See chats | on |
Network
How your device is found and reaches the others. Most of these are right as they are in an office or at home; they are here for the places where BeeBEEP does not find anyone by itself, which finding the people you want to reach explains.
| Control | What it does | Default |
|---|---|---|
| Listening port | the port other devices connect to; read only, and it says not started yet until BeeBEEP has started to listen | 6475 |
| This device's addresses | the addresses someone can type to reach you, one to a line | -- |
| Relay messages for others | when two people cannot reach each other directly, whether their messages may pass through you; opens its own page, below | For everyone on a computer, Only for my contacts on a phone |
| Network effort | how much BeeBEEP does to stay in touch with everyone; opens its own page, below | Normal |
| Talk to BeeBEEP 5.x users | lets BeeBEEP talk to people who still use version 5, whose encryption is weaker; changing it restarts the network; shown only in a build that has the bridge | on |
| Find other devices with Bonjour | also looks for other devices through Bonjour (mDNS), for networks where the broadcast does not reach | on on macOS, iOS and Android, off elsewhere |
| Bluetooth always on | while BeeBEEP is open, keeps Bluetooth on between searches: your contacts nearby see you ("Nearby over Bluetooth") and can write to you without Wi-Fi. Turn it off if Wi-Fi gets slow while it is on. Until the system allows BeeBEEP to use Bluetooth it says so, with Allow Bluetooth under it; BeeBEEP asks only when you tap that, or search with Bluetooth on | on |
| Prefer IPv6 over IPv4 | reaches a device offered on both families over IPv6; applies to the next connection | off |
| Use network password | applies a password shared by every device on this network; leave it off if the network has none | off |
The listening port and the addresses are what you tell someone whose BeeBEEP cannot find you; they add you with Add a user by address in Users (getting started). Both are also on the You tab.
Relay messages for others
When two people cannot reach each other directly, their messages can pass through you. They are never shown on your device, but relaying uses some battery and data.

| Choice | What it does | Default |
|---|---|---|
| For everyone | anyone on the network can reach others through you | the choice on a computer |
| Only for my contacts | only when the sender or the recipient is one of your contacts or shares a group with you | the choice on a phone |
| Never | nobody passes through you; your own messages can still pass through others | no |
The default is tagged on the page itself.
Network effort
More effort notices sooner that someone has left, and costs more traffic.

| Choice | What it does | Default |
|---|---|---|
| Normal | for most offices | the choice |
| High | for a busy LAN on a wired desktop | no |
| Max | for a wired desktop only: five times the idle traffic | no |
When your administrator has set the budgets, the page shows Custom (managed), which you can neither choose nor leave.
Import from BeeBEEP 5.x
It is not a setting but a tool: open the Apps tab and tap Import from BeeBEEP 5.x (on a Mac, also in the menu Apps). It is there on a computer only, and only in a build that has the bridge. It brings the contacts, the groups and the missing parts of your profile over from an older BeeBEEP on the same computer, and its saved chats, which you read in the archive. Nothing already in BeeBEEP is changed. Search this computer looks in the usual folders of a BeeBEEP 5.x installation, and Choose a folder... takes the old BeeBEEP's own folder or its data folder. A report says what was brought over, or that nothing was found.
Network password
Use network password shows a Network password field. Type the password your network uses and press Apply: Restore brings back what was saved. Applying reconnects you to the network, so the people you are talking to drop for a moment and reconnect. The password is also applied when you leave the page. Turning the switch off stops using the password and keeps the one you saved.
When a computer on your network uses another password, BeeBEEP says so in a notice at the top of the window, with that computer's address.

A strong password
Under the field, BeeBEEP says how well your password protects the network: Protection: weak, medium or strong. It is only advice: you can apply any password, unless your administrator asks for a stronger one.
What makes a password strong is how hard it is to guess, and the surest way is length:
- Six or more ordinary words you can remember, with spaces or hyphens between them:
kettle river purple lantern seven moonis strong, and easy to type on every computer of the office. Four or five words give medium, which is enough at home. - Twelve or more mixed characters chosen at random (capitals, small letters, digits and symbols) are strong too, but harder to remember.
- Capitals and symbols help a little on each character; they do not make a short password strong.
Ab1!is weak.
What guessers try first, and so stays weak however it looks:
- a common word or name with a year or a number at the end (
casa1975,ufficio2026); - the usual swaps of letters for digits or symbols (
P@ssw0rd); - runs and keyboard rows (
1234,abcd,qwerty); - the name of the office, the family or BeeBEEP itself.
Security

| Control | What it does | Default |
|---|---|---|
| Accept new security keys automatically | a contact's security key changes when BeeBEEP is reinstalled; on, BeeBEEP accepts the new key by itself; off, you confirm each new key in that contact's chat, and until you do, messages with that contact that pass through other users cannot be delivered | on |
| Always delete data securely | on, what you delete -- a message, an edited message's earlier words, a chat, a voice message -- is overwritten in BeeBEEP's files, not only removed; it applies to what you delete from then on | on |
The key of a contact you verified in person is never replaced automatically, whatever you choose. What to do when a chat says a key has changed is in the FAQ.
BeeBEEP's files are always encrypted, so a deleted message is never readable without your key. Always delete data securely goes further: nothing of it stays in the files at all, even for someone who has the key later. It cannot reach copies made outside BeeBEEP's files: a backup, a snapshot of the disk, or what the disk itself keeps of a file's old place. An administrator may set it for every computer; it then shows the administrator's mark.
Data
Only on a computer, or on a phone while the archive holds something.

| Control | What it does |
|---|---|
| Back up... | saves everything BeeBEEP keeps for you in one file (backing up and restoring) |
| Restore from a backup file... | replaces your data with a backup's, your current data set aside; BeeBEEP closes and starts again by itself (restoring) |
| Open resource folder | opens the folder of the policy file, beebeep.rc (settings for administrators), or, while there is none, the folder BeeBEEP is installed in |
| Open data folder | opens BeeBEEP's data folder in the system's file manager |
| Archive | shown when BeeBEEP has kept copies of your data instead of deleting them, one row each with its day and why; Delete removes one for good, after a confirmation |
When the system does not let BeeBEEP make its data folder private, a notice at the top of the window names the folder: other users of the computer may be able to read it.

Automation
Only on a computer. It lets a program of yours on this computer control BeeBEEP through the local console; it is for people who write such a program, and the rest can leave it alone.
| Control | What it does | Default |
|---|---|---|
| Console | switches the console on; the row says On or Off; switching it off cuts every program at once | off |
| Address | shown while the console is on: where a program connects, with Copy | new at each switch-on |
| Password | shown while the console is on, hidden until you show it, with Copy | new at each switch-on |
| Look only | a program can read your chats and your contacts and change nothing | the choice |
| Act as you | a program can also write and do what you do in BeeBEEP, but never quit it or change its security | no |
The console is off at every start. You choose what a program may do before you switch it on: while it is on, the two choices are greyed and the page says Switch the console off to change this. While programs are connected the page counts them.
A console started from the command line is shown read-only, with what it allows, and has no switch: whoever started it decides when it ends. If it cannot start, the page says why.
Help
For when something goes wrong.

| Control | What it does | Default |
|---|---|---|
| Turn on panic log | writes every message of every category to the log, Qt's own included; meant for troubleshooting one specific report; it takes effect only after BeeBEEP is closed and opened again | off |
| Ask for help | makes one file to attach to a mail or a ticket; BeeBEEP sends nothing by itself (report a problem) | |
| Crash report | on a computer, the reports of the runs that did not end (report a problem) |
About BeeBEEP
The last entry has no switch. Under the bee and the name of BeeBEEP it shows the version you run and a line saying what BeeBEEP is, then:

| Row | What it shows |
|---|---|
| Developed by | who makes BeeBEEP |
| Website | the BeeBEEP website; tap to open it |
| Translations | each language BeeBEEP has, with Native, Reviewed by and the names of its reviewers, or Translated by the BeeBEEP team: help us review it |
| Help translate | the page of the website about translating; tap to open it |
| Third-party software | each component BeeBEEP uses, with its version and license |
A third-party row opens the full license text of the component, with License web page to read it on the web. To translate BeeBEEP yourself, see translating.