Skip to main content

I work on BeeBEEP about 20 hours a week, and it is free for you. Support it

Getting started

Install BeeBEEP, start it, find the people around you, chat, search, send a file, make a group, set up your profile and find the settings.

For: users · From BeeBEEP 6.0.0 · Updated on

BeeBEEP is a messenger for people who share a network: an office, a school, a house. It needs no account and no server, and its messages are encrypted. This page takes you from the download to your first chat, file and group, and says where to look when something is missing.

The tabs

On a phone BeeBEEP has four tabs, at the bottom of the screen, or on the side when the phone is turned:

  • Chats lists your conversations: BEEP, your private chats and your groups.
  • Users lists the people BeeBEEP has seen on your network.
  • Apps holds the tools -- your file transfers, your preset messages -- and the games you installed.
  • You is your own space: your profile on top, and under it the settings.

On a computer or a tablet the settings have a tab of their own, Settings, next to You: at the foot of the side bar, or at the bottom with the others in a narrow window.

The Chats tab with BEEP on top, a chat with Alessandra and filters named All, Unread and Groups

Install BeeBEEP

Windows

Download the installer, beebeep-<version>-windows-x64-setup.exe, run it and finish with Launch BeeBEEP. Can't install? Take the portable zip instead: unpack it, open the BeeBEEP folder and start beebeep.exe. The firewall rule, the portable zip and the silent installation are on installing BeeBEEP on Windows.

macOS

BeeBEEP for macOS is one image, beebeep-<version>-macos-universal.dmg, for every Mac, with Apple silicon or Intel, on macOS 14.4 or newer.

  1. Open the image and drag BeeBEEP onto Applications.
  2. Start BeeBEEP from Applications or Launchpad. The first time, macOS reminds you that it was downloaded from the internet: choose Open.
  3. When BeeBEEP first looks for the others, macOS asks whether it may find and connect to devices on your local network: choose Allow. Without it BeeBEEP finds nobody. If you chose Don't Allow, open System Settings > Privacy & Security > Local Network and turn BeeBEEP on.

If you used another build of BeeBEEP on this Mac before, a test build for example, macOS may ask at the first start whether BeeBEEP may use the confidential information stored in "BeeBEEP" in your keychain: that is the key to your data, and the answer is Always Allow. With Deny, BeeBEEP does not open your data this time and says so; nothing is lost, and at the next start you can answer again.

Closing the window leaves BeeBEEP running, in the Dock, as every Mac application: messages keep arriving. Click its icon in the Dock to bring the window back; press Command-Q, or choose Quit in the BeeBEEP menu, to quit.

If the macOS firewall is on and asks whether BeeBEEP may accept incoming connections, choose Allow: see what the network must let through.

Linux

BeeBEEP for Linux is for 64-bit Intel and AMD computers with Ubuntu 22.04, Debian 12 or a newer system. It comes in three forms, and you need one:

FileWhat to do
beebeep_<version>-1_amd64.debinstall it, then start BeeBEEP from the applications menu or beebeep from a terminal
BeeBEEP-<version>-x86_64.AppImagemake it executable and run it, nothing is installed
beebeep-<version>-linux-x86_64.tar.gzunpack it and run ./beebeep from the folder

To install the package from a terminal:

sudo apt install ./beebeep_<version>-1_amd64.deb

To run the AppImage:

chmod +x BeeBEEP-<version>-x86_64.AppImage
./BeeBEEP-<version>-x86_64.AppImage

Where each keeps your data, the AppImage without FUSE, the tray on GNOME, the firewall's lines, BeeBEEP 5.x on the same computer and uninstalling are on installing BeeBEEP on Linux.

The first start

The first time, BeeBEEP opens on Welcome to BeeBEEP. Get started goes on; on a computer, Restore from a backup file... under it brings back a backup made on another computer instead (backing up and restoring). Then BeeBEEP asks two things: how you appear to others, then where you are.

The first screen: the bee and Welcome to BeeBEEP in the middle, a Get started button at the bottom and under it Restore from a backup file...

The profile screen, 1 of 2, with Back at the top, a round picture marked M on a faint honeycomb, a camera button on it, a row of colors, a Display name field, Advanced options and a Next button at the bottom

  1. Check the Display name. BeeBEEP suggests the name of your account on the computer; type another if you like, and the letters on the picture follow. A name starts with a letter or a digit and has at most 40 characters.
  2. Tap a color under the picture, or the camera on it to choose a photo of your own.
  3. Advanced options holds two things. On a computer, Start BeeBEEP when you log in is the switch that opens BeeBEEP by itself each time you log in; turn it off if you prefer to open it yourself. The picture shows the words for a computer with a system tray; without one, BeeBEEP starts minimized instead. Network password is for a network whose BeeBEEP all share a password: type it here and BeeBEEP uses it from the first moment. Leave it empty otherwise; you can set it later in Settings > Network. It is the only password BeeBEEP ever asks you to type.

    The same screen with Advanced options open: the Start BeeBEEP when you log in switch, on, saying it stays in the system tray and receives your messages, then a Network password field with an eye button, the sentence about it and the Next button

  4. Press Next.
  5. Answer Where are you using BeeBEEP? with a tap on a place. Somewhere you trust (home, the office, a friend's place) makes the network private: the people you find there become your contacts, so you can invite them to groups and their files arrive without asking. In a public place (a cafe, a hotel, an airport, a school) makes it public.

    2 of 2: the network with its name and addresses, Where are you using BeeBEEP?, the two places, and Later at the bottom

    Later starts BeeBEEP without an answer: it asks again the next time you start it on that network. Until you answer, the network counts as public; you can change it in Settings > Networks. Back returns to the first step. On a phone or a tablet BeeBEEP does not ask this yet.

Your name, color and photo can be changed afterwards, whenever you like. The password cannot: this is the only time BeeBEEP asks for it. BeeBEEP then opens on Users, where the first people found appear.

Each later start opens on Chats once a conversation holds a message, or once the history of BeeBEEP 5.x is there (coming from BeeBEEP 5.x); until then it opens on Users again.

See who is there

Open Users. Anyone on the same Wi-Fi or the same cable who runs BeeBEEP appears by itself within a moment, in colour with Online under the name while connected. There is nothing to add and nothing to accept.

The Users tab, the filters under its title over Alessandra, Christian, Laura and Massimo, each marked Contact and Online

The filters under the title filter the list: All, Contacts, Online, Favorites and Blocked; Online shows whoever you can reach now, also through another user. The search by name opens as in Chats (Finding a chat or a user). The person with a magnifier at the top looks again for the people nearby, in the ways switched on under the +, and the line under the title says it is looking. The arrow beside the + sorts the list, and you can group people by circle if you use them (circles).

When nobody has appeared, the screen says so and lists the usual causes: BeeBEEP is not running on the other device, the two devices are not on the same network (a guest Wi-Fi keeps its devices apart), or a firewall is in the way. Your own address and port are on the You tab: tell them to someone whose BeeBEEP cannot find you, and they add you with the + of the Users tab, Add a user by address. I don't see anyone online goes through every cause.

Contacts

A Contact is a user you trust: contacts see your profile details, and files they send you download by themselves, up to the size Settings > Preferences sets. Users you meet are not contacts at first. When you join a network, BeeBEEP asks whether it is a private place, like home or the office: Private makes the people you meet there your contacts, Public does not.

To make one user a contact, or to stop, open the user and use the Contact switch.

A user's details with the Contact switch on, the circles you share with them, and what they see of you and what you accept from them

Write to someone

In Users, tap a person to open the chat with them; the i at the right of the row opens their details instead. A person you have already written to is also in Chats. Type in Message and send it: on a computer Return sends and Shift+Return starts a new line, and the round button at the right sends too. When the field is empty that button is a microphone, and records a voice message; if the system does not let BeeBEEP use the microphone, a line says where to allow it and nothing is recorded. A message may have up to 10,000 characters; Send as file offers to send a longer one as a file.

A chat with Alessandra: two messages received and one sent, and the message field with a plus, an emoji button and a microphone

The + beside the field also holds Preset messages: texts you write once -- "I'm in a meeting, I'll call you back", an address -- and send again with a tap. Tips says how.

A long-press on a message (a right-click on a computer) opens its actions: Reply, Forward, Copy, Info, Important and, under More, Select, Pin and Delete. Tips says what each one is for.

BEEP is the first chat of the list: what you write there goes to every user online right now who takes part in it, contacts or not, and is not kept for whoever comes later. A BEEP is short and text only. BEEP tells you more.

A chat you no longer want in the list can be archived: a long-press on it in Chats (a right-click on a computer) offers Archive chat, and so does the chat itself: the archive button at the top, or Chat options (the button at the right of the header) on a phone. It moves to Archive, at the top of Chats, with all its messages, and you can still open it and write there. A new message leaves it in Archive, with no notification unless it mentions you, and its unread count shows on Archive instead of on the tab. Unarchive chat brings it back. The chat of someone BeeBEEP has not seen for a long time goes to Archive by itself, and comes back when that person does. BEEP is never archived. The archive says more.

Finding a chat or a user

Chats and Users each have a search by name at the top of their list, opened the same way in both.

  • On a phone or tablet, pull the list down past its top.
  • On a computer, click the magnifier at the top -- there only when the list is longer than the window --, just start typing while the list is in front of you, or press Ctrl+F (Cmd+F on a Mac). With a chat open beside the list, Ctrl+F searches the side you last clicked in: the list, or the chat's messages.

Up to three letters find the names that begin with them; from four on, a name that holds them anywhere. Capitals do not matter. Chats searches the names of the chats -- a person's name, a group's name -- not what was written in them: to find a message, search inside the chat (Searching in a chat). Escape, or emptying the field, shows the whole list again.

Send a file

In a private chat or in a group:

  • tap the + beside the message field, Send a file, and choose the file; or
  • on a computer, drag one or more files from your file manager onto the chat. Folders cannot be sent: drop files.

The other person sees the file in the chat. If they are your contact and the file is not larger than they allowed, it downloads by itself; if not, they see Accept and Reject and decide. While you wait for them, Cancel withdraws the offer. The File transfers button at the top of Chats lists the transfers in progress, with Pause, Resume and Cancel. Sending and receiving files tells the rest.

Make a group

A group is a chat among the people you choose, each of whom accepts an invitation to join. Groups has the whole story.

  1. In Chats, tap the + (New group).
  2. Type the Group name, tap the picture if you want another color, and press Create.
  3. In the group's details, which open by themselves, tap Invite under Members and choose the people, with a message if you want.

Each person you invite sees the invitation in a chat with you, with Accept and Decline. To see a group's details later, tap its name at the top of its chat. They list the Administrators, who can invite and remove people, the Members and the Pending invitations, which an administrator can Withdraw. Leave group takes you out; to come back you need a new invitation from an administrator.

A group that keeps itself

Under Automatic members, when you create a group or later in its details, a group can look after its members by itself:

  • Add contacts to this group automatically invites your Contacts online each time one comes online, or All your contacts, online or not. Each one is invited and joins on accepting; someone who declined is not asked again. It is how a small office keeps a group of everyone.
  • Remove automatically members not seen for 90 days takes out the members you have not seen for that many days of use of BeeBEEP on this device; administrators are never removed. It is on for every new group, with the number set in Settings > Privacy; type another number or turn it off.

New group with the two rules on: contacts online invited, members not seen for 60 days removed

Every member sees the rules in the group's details. Each administrator's BeeBEEP removes the members it has not seen for that many days; only the administrator who set the rules last invites, from their own contacts. An administrator who changes the rules makes them theirs, and their contacts are then the ones invited.

Your profile and picture

Open You: on a phone, tap your name at the top; on a computer the tab is your profile. It shows your name, your picture, your details, the circles you are in and your address.

The You tab with a round picture marked M and a camera button on it, the name below it, a Circles card listing two circles and an address with its port

  • The camera on your picture chooses a photo from your files: a PNG, JPEG, BMP or GIF.
  • The pencil, Edit, opens Edit profile: the picture's color, your Display name, First name, Last name, Birth date, Email, Phone number, Location and Info. Changes are saved when you leave the screen, and Restore brings back what was saved.
  • Your display name and picture are seen by everyone. The other fields are seen only by your contacts, unless you change it in Settings > Privacy.

Where the settings are

On a computer or a tablet, open the Settings tab. On a phone, open You: the settings are listed under your name. Wherever this guide says Settings, on a phone it means that list.

The Settings list: General, Preferences, Privacy, Notifications, Audio, Appearance, Emoji and stickers, Network, Security, Data and Automation

The first group is what you use every day: General (how BeeBEEP runs on a computer or on Android), Preferences, Privacy, Notifications, Audio (on a computer), Appearance and Emoji and stickers. The second is Network, Security, Data, Automation (on a computer only) and Help. About BeeBEEP shows the version, the credits and the translations. Settings goes through every entry.

All the help pages