Crocodile 0.9.0 beta

A beta release of Crocodile: peer-to-peer, end-to-end encrypted voice, video
and text chat. It works, but expect rough edges, and note that it hasn't had an
independent security audit yet.

What's new in 0.9.0

A security release: everyone should update, and server operators should update
all their servers together. Older versions and this one cannot talk to each
other in a few places (listed under "Updating").

• Stricter checks between servers. Servers check more carefully who a
  message, a presence update or a session request comes from, limit how quickly
  one server can introduce others, and a device now signs its own part in a
  conversation, so a server that it isn't connected to can't speak for it.
• Chat messages and files are tied to the space they were sent in. Messages
  name their space and file ids are tied to their author.
• Invite links. A space has one open link at a time, lasting at most 30
  days, and its secret stays in the link: no server learns it. You can also
  invite one person by name. Member lists are shown only to the space's owner
  and members. Links made by older versions stop working; make a new one.
• Linking a new device is harder to tamper with. The security code is
  checked before the account is sent, and the transfer is protected against
  future quantum computers like the rest of the app.
• Conversations from people you don't know wait as requests. Nothing of
  yours is shared with them until you accept.
• Blocking works in spaces. A blocked member's messages are not kept, and
  keys and files are not given to them.
• Removed devices clean up after themselves. A device you remove from your
  account stops and clears its copy of the account the next time it is online.
• Voice and video. Each frame is accepted once, voice stays at a constant
  bitrate whatever the host's description says, and members' keys can't displace
  each other.
• A calmer desktop app. The app's window only shows its own pages, the
  parts of the app that talk to your computer check what they are asked, release
  builds switch off the debugging doors, files you receive are marked as
  coming from outside, and there is a warning when your system has no keychain.
• Command line tool. It shows other people's text without hidden control
  characters, saves a received file only once it is whole, and runs one command
  at a time per account.
• Servers stay responsive under load. Long answers are sent in parts,
  lookups of many profiles make fewer requests between servers, requests and
  replies are limited per address, and each account can store a bounded amount.
• Directory and relay hardening. The public directory checks a server's
  address more carefully before listing it (a server behind a redirect or on a
  private address is not listed; set CROC_DIR_ALLOW_PRIVATE=1 for a directory
  on a private network). The built-in relay reads requests exactly as they were
  signed, and --relay-own-ips lets it avoid more of its own machine's
  addresses.
• Installers check what they download. The one-line installers fetch over
  https only and compare each download with the checksum the release lists
  before installing it.
• Up-to-date components. Electron 44.10.0 with Chromium 152.0.7977.169 (from
  152.0.7977.167, with upstream security fixes), WebRTC (werift), the build tools
  and the app's libraries.

Updating

• Server operators: this release uses protocol 4. Servers on older versions
  cannot link to it, so update them all together. Behind a reverse proxy, set
  --trust-proxy; the self-hosting compose file now publishes the directory on
  127.0.0.1 only (CROC_DIR_BIND=0.0.0.0 to change it). See the
  self-hosting guide.
• Everyone else: click Update in the top bar. New messages and files from
  people who have not updated yet will not appear until they do, and a device
  cannot be linked between an old and a new version: update both first.

Download

System	File
Windows (x64 and ARM)	the .exe installer
macOS (Intel and Apple)	the .dmg (universal)
Linux	.AppImage, .deb (Debian/Ubuntu), .rpm (Fedora/openSUSE), .tar.gz

Or install with one line in a terminal, which avoids the warnings below; see
the README.

These builds are not code-signed yet:

• Windows: SmartScreen says "Windows protected your PC" → More info →
  Run anyway.
• macOS: open the app once, then System Settings → Privacy & Security →
  Open Anyway.

The app tells you when a new version is out: click Update in the top bar,
then Restart to update once it has downloaded. Two exceptions: the Linux
.tar.gz can't update itself, so Download update opens this page; and a
Mac app that can't replace itself (still on the disk image, or in a folder you
can't write to) downloads the new .dmg and shows Install update, which
opens it so you can drag Crocodile into Applications.

Getting started

Open Crocodile, pick a name and save your recovery key. The app finds a
coordination server by itself. Add friends under Home → Add someone
(name#1234), create a space, share the invite, and talk.

Want to run your own server instead, for example on a home network? Turn on
Settings → Host a server and share the address it shows; others add it
under Settings → Network → Preferred servers. See the
self-hosting guide.

What to try

• Text chat in a space and in DMs; send a DM while your friend is offline and
  see it arrive when they're back.
• Voice rooms with three or more people; leave as the host (the crown / radio
  icon) and check the others stay connected.
• Push-to-talk while another app is focused (Settings → Voice).
• Link a second computer (account menu → Link another device).
• Make a new invite link for a space, or invite one person by name.
• Light/dark theme and accent colours (Settings → Appearance).

Found a problem? Open an
issue and attach
Settings → About → Copy diagnostics (it contains no messages). Report
security problems
privately.

Crocodile 0.8.3 beta

A beta release of Crocodile: peer-to-peer, end-to-end encrypted voice, video
and text chat. It works, but expect rough edges, and note that it hasn't had an
independent security audit yet.

What's new in 0.8.3

A maintenance release: no new features, but everyone should update.

• Security fixes from Chromium. The app now runs on Electron 44.9.3 with
  Chromium 152.0.7977.167 (from 152.0.7977.130), which brings upstream
  fixes for Chromium, V8, ANGLE, PDFium and Skia.
• Up-to-date libraries. WebRTC (werift 0.25), the server framework
  (Fastify 5.12.7) and validation (zod 4.6.7) are on their latest versions.
  The command-line tool gets the same updates.
• When the microphone or camera can't be opened, the diagnostics now keep
  the underlying error alongside the message you see.

Download

System	File
Windows (x64 and ARM)	the .exe installer
macOS (Intel and Apple)	the .dmg (universal)
Linux	.AppImage, .deb (Debian/Ubuntu), .rpm (Fedora/openSUSE), .tar.gz

Or install with one line in a terminal, which avoids the warnings below; see
the README.

These builds are not code-signed yet:

• Windows: SmartScreen says "Windows protected your PC" → More info →
  Run anyway.
• macOS: open the app once, then System Settings → Privacy & Security →
  Open Anyway.

The app tells you when a new version is out: click Update in the top bar,
then Restart to update once it has downloaded. Two exceptions: the Linux
.tar.gz can't update itself, so Download update opens this page; and a
Mac app that can't replace itself (still on the disk image, or in a folder you
can't write to) downloads the new .dmg and shows Install update, which
opens it so you can drag Crocodile into Applications.

Getting started

Open Crocodile, pick a name and save your recovery key. The app finds a
coordination server by itself. Add friends under Home → Add someone
(name#1234), create a space, share the invite, and talk.

Want someone to talk to right away? Join the public Lounge with the
invite in the README.

Want to run your own server instead, for example on a home network? Turn on
Settings → Host a server and share the address it shows; others add it
under Settings → Network → Preferred servers. See the
self-hosting guide.

What to try

• Text chat in a space and in DMs; send a DM while your friend is offline and
  see it arrive when they're back.
• Voice rooms with three or more people; leave as the host (the crown / radio
  icon) and check the others stay connected.
• Push-to-talk while another app is focused (Settings → Voice).
• Link a second computer (account menu → Link another device).
• Light/dark theme and accent colours (Settings → Appearance).

Found a problem? Open an
issue and attach
Settings → About → Copy diagnostics (it contains no messages). Report
security problems
privately.

Crocodile 0.8.2 beta

A beta release of Crocodile: peer-to-peer, end-to-end encrypted voice, video
and text chat. It works, but expect rough edges, and note that it hasn't had an
independent security audit yet.

What's new in 0.8.2

• Video calls. Next to the call button in a conversation there is now a
  video call button: it rings your friend with your camera already on, so you
  see yourself while it rings. They see "is video calling you" and can answer
  with their camera on or off.
• Calling back right away works. Hanging up and calling the same person
  again straight away could end the new call by itself.
• Video for everyone in the call. Depending on how a connection was
  set up, a member could be stuck on "Video is getting ready…" for the whole
  call.
• A video call shows as a normal call to friends still on 0.8.1 or older.

Download

System	File
Windows (x64 and ARM)	the .exe installer
macOS (Intel and Apple)	the .dmg (universal)
Linux	.AppImage, .deb (Debian/Ubuntu), .rpm (Fedora/openSUSE), .tar.gz

Or install with one line in a terminal, which avoids the warnings below; see
the README.

These builds are not code-signed yet:

• Windows: SmartScreen says "Windows protected your PC" → More info →
  Run anyway.
• macOS: open the app once, then System Settings → Privacy & Security →
  Open Anyway.

The app tells you when a new version is out: click Update in the top bar,
then Restart to update once it has downloaded. Two exceptions: the Linux
.tar.gz can't update itself, so Download update opens this page; and a
Mac app that can't replace itself (still on the disk image, or in a folder you
can't write to) downloads the new .dmg and shows Install update, which
opens it so you can drag Crocodile into Applications.

Getting started

Open Crocodile, pick a name and save your recovery key. The app finds a
coordination server by itself. Add friends under Home → Add someone
(name#1234), create a space, share the invite, and talk.

Want to run your own server instead, for example on a home network? Turn on
Settings → Host a server and share the address it shows; others add it
under Settings → Network → Preferred servers. See the
self-hosting guide.

What to try

• Text chat in a space and in DMs; send a DM while your friend is offline and
  see it arrive when they're back.
• Voice rooms with three or more people; leave as the host (the crown / radio
  icon) and check the others stay connected.
• Push-to-talk while another app is focused (Settings → Voice).
• Link a second computer (account menu → Link another device).
• Light/dark theme and accent colours (Settings → Appearance).

Found a problem? Open an
issue and attach
Settings → About → Copy diagnostics (it contains no messages). Report
security problems
privately.

Crocodile 0.8.1 beta

A beta release of Crocodile: peer-to-peer, end-to-end encrypted voice, video
and text chat. It works, but expect rough edges, and note that it hasn't had an
independent security audit yet.

What's new in 0.8.1

• Full screen works for a shared screen. Clicking Full screen on a
  screen you watch did nothing in 0.8.0; now it fills your display. Click
  Exit full screen (or press Esc) to go back.

Download

System	File
Windows (x64 and ARM)	the .exe installer
macOS (Intel and Apple)	the .dmg (universal)
Linux	.AppImage, .deb (Debian/Ubuntu), .rpm (Fedora/openSUSE), .tar.gz

Or install with one line in a terminal, which avoids the warnings below; see
the README.

These builds are not code-signed yet:

• Windows: SmartScreen says "Windows protected your PC" → More info →
  Run anyway.
• macOS: open the app once, then System Settings → Privacy & Security →
  Open Anyway.

The app tells you when a new version is out: click Update in the top bar,
then Restart to update once it has downloaded. Two exceptions: the Linux
.tar.gz can't update itself, so Download update opens this page; and a
Mac app that can't replace itself (still on the disk image, or in a folder you
can't write to) downloads the new .dmg and shows Install update, which
opens it so you can drag Crocodile into Applications.

Getting started

Open Crocodile, pick a name and save your recovery key. The app finds a
coordination server by itself. Add friends under Home → Add someone
(name#1234), create a space, share the invite, and talk.

Want to run your own server instead, for example on a home network? Turn on
Settings → Host a server and share the address it shows; others add it
under Settings → Network → Preferred servers. See the
self-hosting guide.

What to try

• Text chat in a space and in DMs; send a DM while your friend is offline and
  see it arrive when they're back.
• Voice rooms with three or more people; leave as the host (the crown / radio
  icon) and check the others stay connected.
• Push-to-talk while another app is focused (Settings → Voice).
• Link a second computer (account menu → Link another device).
• Light/dark theme and accent colours (Settings → Appearance).

Found a problem? Open an
issue and attach
Settings → About → Copy diagnostics (it contains no messages). Report
security problems
privately.

Crocodile 0.8.0 beta

A beta release of Crocodile: peer-to-peer, end-to-end encrypted voice, video
and text chat. It works, but expect rough edges, and note that it hasn't had an
independent security audit yet.

What's new in 0.8.0

• Video calls. Turn your camera on in a DM call or a voice room with the
  camera button. You see yourself first, pick a camera, then turn it on.
  Everyone in the call sees it as a tile; people without a camera on show as
  their picture.
• Screen sharing. Share a whole screen or one window. Choose Text and
  slides (sharp, up to 1080p, a few frames a second) or Motion (smooth,
  720p, 30 frames a second). Others see that you're sharing and click
  Watch if they want to; nobody gets a screen they didn't ask for. Watch
  it large, full screen, or in a pop-out window that stays on top while you
  do something else.
• Share your computer's sound with a screen, on Windows. On macOS and
  Linux, screens are shared without sound for now.
• End-to-end encrypted, like voice. Video goes from your computer to the
  people in the call through the device of the member who hosts it, which
  forwards it without being able to see it. It never goes through a server,
  not even the optional relay: if your connection needs the relay, the call
  stays voice only and the app tells you why.
• Shared fairly. The host's upload decides how much video a call can
  carry. If it's full, the streams that don't fit pause (you see that they
  are paused) and resume when there's room; cameras you already see are kept
  first.
• On macOS, Crocodile asks for access to the camera, and to screen recording
  the first time you share (System Settings → Privacy & Security → Screen
  Recording).
• Video needs 0.8.0 on everyone's computer, the host's in particular: with
  an older host the call stays voice only and the app says so.

Download

System	File
Windows (x64 and ARM)	the .exe installer
macOS (Intel and Apple)	the .dmg (universal)
Linux	.AppImage, .deb (Debian/Ubuntu), .rpm (Fedora/openSUSE), .tar.gz

Or install with one line in a terminal, which avoids the warnings below; see
the README.

These builds are not code-signed yet:

• Windows: SmartScreen says "Windows protected your PC" → More info →
  Run anyway.
• macOS: open the app once, then System Settings → Privacy & Security →
  Open Anyway.

The app tells you when a new version is out: click Update in the top bar,
then Restart to update once it has downloaded. Two exceptions: the Linux
.tar.gz can't update itself, so Download update opens this page; and a
Mac app that can't replace itself (still on the disk image, or in a folder you
can't write to) downloads the new .dmg and shows Install update, which
opens it so you can drag Crocodile into Applications.

Getting started

Open Crocodile, pick a name and save your recovery key. The app finds a
coordination server by itself. Add friends under Home → Add someone
(name#1234), create a space, share the invite, and talk.

Want to run your own server instead, for example on a home network? Turn on
Settings → Host a server and share the address it shows; others add it
under Settings → Network → Preferred servers. See the
self-hosting guide.

What to try

• Text chat in a space and in DMs; send a DM while your friend is offline and
  see it arrive when they're back.
• Turn your camera on in a call and in a voice room; share a screen in both
  qualities and watch someone else's, full screen and in a pop-out window.
• Send a picture, a video and a big file; close the sender's app once
  someone has downloaded it and fetch it on a third computer.
• Voice rooms with three or more people; leave as the host (the crown / radio
  icon) and check the others stay connected.
• Push-to-talk while another app is focused (Settings → Voice).
• Link a second computer (account menu → Link another device).
• Light/dark theme and accent colours (Settings → Appearance).

Found a problem? Open an
issue and attach
Settings → About → Copy diagnostics (it contains no messages). Report
security problems
privately.

Crocodile 0.7.0 beta

A beta release of Crocodile: peer-to-peer, end-to-end encrypted voice and
text chat. It works, but expect rough edges, and note that it hasn't had an
independent security audit yet.

What's new in 0.7.0

• Send files. Attach files with the paperclip, drag them onto a
  conversation or paste them, in DMs and in space channels, any size. They
  go straight from your computer to the people you send them to, end-to-end
  encrypted, and never through a server, not even the optional relay.
• Pictures and videos in the chat. They show as a blurred preview until
  they arrive, then as the picture (click to enlarge) or a player. Up to
  10 MB they arrive by themselves from friends and in DMs; anything else
  waits for your click. Change that under Settings → Files.
• Files stay available. Anyone who downloaded a file can pass it on to
  others in the same space or DM while their app is open, so it doesn't
  disappear when the sender goes offline. A download that drops resumes
  where it stopped, and every piece is checked against what the sender
  signed. You can turn sharing off, and see and free the space files take,
  under Settings → Files.
• Crocodile on the command line. crocodile send report.pdf --to alice#1234 and crocodile get send and receive files from a terminal,
  peer-to-peer like the app, for servers, scripts and anyone who prefers a
  shell. Link it to your account with crocodile link, or give it its own
  with crocodile init. Install it with npm install -g crocodile-cli, or as
  a standalone program with the install script's --cli option; see the
  README.
• Everyone needs 0.7.0 to see files: older versions skip those messages.

Download

System	File
Windows (x64 and ARM)	the .exe installer
macOS (Intel and Apple)	the .dmg (universal)
Linux	.AppImage, .deb (Debian/Ubuntu), .rpm (Fedora/openSUSE), .tar.gz

Or install with one line in a terminal, which avoids the warnings below; see
the README.

These builds are not code-signed yet:

• Windows: SmartScreen says "Windows protected your PC" → More info →
  Run anyway.
• macOS: open the app once, then System Settings → Privacy & Security →
  Open Anyway.

The app tells you when a new version is out: click Update in the top bar,
then Restart to update once it has downloaded. Two exceptions: the Linux
.tar.gz can't update itself, so Download update opens this page; and a
Mac app that can't replace itself (still on the disk image, or in a folder you
can't write to) downloads the new .dmg and shows Install update, which
opens it so you can drag Crocodile into Applications.

Getting started

Open Crocodile, pick a name and save your recovery key. The app finds a
coordination server by itself. Add friends under Home → Add someone
(name#1234), create a space, share the invite, and talk.

Want to run your own server instead, for example on a home network? Turn on
Settings → Host a server and share the address it shows; others add it
under Settings → Network → Preferred servers. See the
self-hosting guide.

What to try

• Text chat in a space and in DMs; send a DM while your friend is offline and
  see it arrive when they're back.
• Send a picture, a video and a big file; close the sender's app once
  someone has downloaded it and fetch it on a third computer.
• Voice rooms with three or more people; leave as the host (the crown / radio
  icon) and check the others stay connected.
• Push-to-talk while another app is focused (Settings → Voice).
• Link a second computer (account menu → Link another device).
• Light/dark theme and accent colours (Settings → Appearance).

Found a problem? Open an
issue and attach
Settings → About → Copy diagnostics (it contains no messages). Report
security problems
privately.

Crocodile 0.6.1 beta

A beta release of Crocodile: peer-to-peer, end-to-end encrypted voice and
text chat. It works, but expect rough edges, and note that it hasn't had an
independent security audit yet.

What's new in 0.6.1

• One place to answer a call. While a call rang for you, the conversation
  with the caller already looked like a call in progress, with its own
  Accept and Decline next to the incoming-call prompt. Now the prompt is the
  only place to answer, and the conversation shows the call once you're in
  it. The caller no longer sees the ringing twice either.

Download

System	File
Windows (x64 and ARM)	the .exe installer
macOS (Intel and Apple)	the .dmg (universal)
Linux	.AppImage, .deb (Debian/Ubuntu), .rpm (Fedora/openSUSE), .tar.gz

Or install with one line in a terminal, which avoids the warnings below; see
the README.

These builds are not code-signed yet:

• Windows: SmartScreen says "Windows protected your PC" → More info →
  Run anyway.
• macOS: open the app once, then System Settings → Privacy & Security →
  Open Anyway.

The app tells you when a new version is out: click Update in the top bar,
then Restart to update once it has downloaded. Two exceptions: the Linux
.tar.gz can't update itself, so Download update opens this page; and a
Mac app that can't replace itself (still on the disk image, or in a folder you
can't write to) downloads the new .dmg and shows Install update, which
opens it so you can drag Crocodile into Applications.

Getting started

Open Crocodile, pick a name and save your recovery key. The app finds a
coordination server by itself. Add friends under Home → Add someone
(name#1234), create a space, share the invite, and talk.

Want to run your own server instead, for example on a home network? Turn on
Settings → Host a server and share the address it shows; others add it
under Settings → Network → Preferred servers. See the
self-hosting guide.

What to try

• Text chat in a space and in DMs; send a DM while your friend is offline and
  see it arrive when they're back.
• Voice rooms with three or more people; leave as the host (the crown / radio
  icon) and check the others stay connected.
• Push-to-talk while another app is focused (Settings → Voice).
• Link a second computer (account menu → Link another device).
• Light/dark theme and accent colours (Settings → Appearance).

Found a problem? Open an
issue and attach
Settings → About → Copy diagnostics (it contains no messages). Report
security problems
privately.

Crocodile 0.6.0 beta

A beta release of Crocodile: peer-to-peer, end-to-end encrypted voice and
text chat. It works, but expect rough edges, and note that it hasn't had an
independent security audit yet.

What's new in 0.6.0

Calls

• Hanging up ends the call for both of you. Before, the other side stayed in
  the call, with its timer running.
• The call timer and the green dot show only while a call is actually live.
  Otherwise the call says what it's doing: Ringing…, Connecting…,
  Waiting for Bob to join, Reconnecting…. A call also ends by itself if
  the other side leaves it, or stays gone for 20 seconds.
• Calls with a friend look like voice rooms: both of you on a stage above the
  chat, with mute, deafen and hang-up buttons, and Join call if they're
  already in it.
• Live latency: every call member shows their round trip to the host's
  device (green, amber or red), and the call bar shows yours.

Chat

• Links work, including www. addresses and plain domains such as
  example.com/page. They open in your browser.
• Invite links become a card with the space's name and a Join button.
• @mentions: type @ to pick someone. A message that mentions you
  stands out, and its notification says so.
• Emoji: a picker next to the send button, suggestions as you type
  :name, and :shortcode: turns into the emoji.
• Right-click menus: reply, copy, edit or delete a message, cut, copy and
  paste in text fields, spelling suggestions, and copy links.

Sounds

Ringing, people joining and leaving calls, hanging up, new messages and
mentions. Turn them off or set their volume under Settings → Privacy &
alerts. They're quiet while you're busy.

Space admins

A space's owner can now let others help run it: open Space settings →
People and switch on the members you trust. Admins can rename the space,
change its icon, add and remove channels and rooms, invite people and ban
members. Only the owner chooses admins or deletes the space. When the owner
removes an admin, their later changes are refused and the invites they made
stop working.

Updating

Everyone in a call should update. With an older version on the other end,
calls still work, but the live state and latency show only partly. Admins'
changes need coordination servers that run this version; servers on older
versions refuse them until they update.

Download

System	File
Windows (x64 and ARM)	the .exe installer
macOS (Intel and Apple)	the .dmg (universal)
Linux	.AppImage, .deb (Debian/Ubuntu), .rpm (Fedora/openSUSE), .tar.gz

Or install with one line in a terminal, which avoids the warnings below; see
the README.

These builds are not code-signed yet:

• Windows: SmartScreen says "Windows protected your PC" → More info →
  Run anyway.
• macOS: open the app once, then System Settings → Privacy & Security →
  Open Anyway.

The app tells you when a new version is out: click Update in the top bar,
then Restart to update once it has downloaded. Two exceptions: the Linux
.tar.gz can't update itself, so Download update opens this page; and a
Mac app that can't replace itself (still on the disk image, or in a folder you
can't write to) downloads the new .dmg and shows Install update, which
opens it so you can drag Crocodile into Applications.

Getting started

Open Crocodile, pick a name and save your recovery key. The app finds a
coordination server by itself. Add friends under Home → Add someone
(name#1234), create a space, share the invite, and talk.

Want to run your own server instead, for example on a home network? Turn on
Settings → Host a server and share the address it shows; others add it
under Settings → Network → Preferred servers. See the
self-hosting guide.

What to try

• Text chat in a space and in DMs; send a DM while your friend is offline and
  see it arrive when they're back.
• Voice rooms with three or more people; leave as the host (the crown / radio
  icon) and check the others stay connected.
• Push-to-talk while another app is focused (Settings → Voice).
• Link a second computer (account menu → Link another device).
• Light/dark theme and accent colours (Settings → Appearance).

Found a problem? Open an
issue and attach
Settings → About → Copy diagnostics (it contains no messages). Report
security problems
privately.

Crocodile 0.5.1 beta

A beta release of Crocodile: peer-to-peer, end-to-end encrypted voice and
text chat. It works, but expect rough edges, and note that it hasn't had an
independent security audit yet.

Download

System	File
Windows (x64 and ARM)	the .exe installer
macOS (Intel and Apple)	the .dmg (universal)
Linux	.AppImage, .deb (Debian/Ubuntu), .rpm (Fedora/openSUSE), .tar.gz

Or install with one line in a terminal, which avoids the warnings below; see
the README.

These builds are not code-signed yet:

• Windows: SmartScreen says "Windows protected your PC" → More info →
  Run anyway.
• macOS: open the app once, then System Settings → Privacy & Security →
  Open Anyway.

The app tells you when a new version is out: click Update in the top bar,
then Restart to update once it has downloaded. Two exceptions: the Linux
.tar.gz can't update itself, so Download update opens this page; and a
Mac app that can't replace itself (still on the disk image, or in a folder you
can't write to) downloads the new .dmg and shows Install update, which
opens it so you can drag Crocodile into Applications.

Getting started

Open Crocodile, pick a name and save your recovery key. The app finds a
coordination server by itself. Add friends under Home → Add someone
(name#1234), create a space, share the invite, and talk.

Want to run your own server instead, for example on a home network? Turn on
Settings → Host a server and share the address it shows; others add it
under Settings → Network → Preferred servers. See the
self-hosting guide.

What to try

• Text chat in a space and in DMs; send a DM while your friend is offline and
  see it arrive when they're back.
• Voice rooms with three or more people; leave as the host (the crown / radio
  icon) and check the others stay connected.
• Push-to-talk while another app is focused (Settings → Voice).
• Link a second computer (account menu → Link another device).
• Light/dark theme and accent colours (Settings → Appearance).

Found a problem? Open an
issue and attach
Settings → About → Copy diagnostics (it contains no messages). Report
security problems
privately.

Crocodile 0.5.0 beta

A beta release of Crocodile: peer-to-peer, end-to-end encrypted voice and
text chat. It works, but expect rough edges, and note that it hasn't had an
independent security audit yet.

Download

System	File
Windows (x64 and ARM)	the .exe installer
macOS (Intel and Apple)	the .dmg (universal)
Linux	.AppImage, .deb (Debian/Ubuntu), .rpm (Fedora/openSUSE), .tar.gz

Or install with one line in a terminal, which avoids the warnings below; see
the README.

These builds are not code-signed yet:

• Windows: SmartScreen says "Windows protected your PC" → More info →
  Run anyway.
• macOS: open the app once, then System Settings → Privacy & Security →
  Open Anyway.

The app tells you when a new version is out: click Update in the top bar,
then Restart to update once it has downloaded. Two exceptions: the Linux
.tar.gz can't update itself, so Download update opens this page; and a
Mac app that can't replace itself (still on the disk image, or in a folder you
can't write to) downloads the new .dmg and shows Install update, which
opens it so you can drag Crocodile into Applications.

Getting started

Open Crocodile, pick a name and save your recovery key. The app finds a
coordination server by itself. Add friends under Home → Add someone
(name#1234), create a space, share the invite, and talk.

Want to run your own server instead, for example on a home network? Turn on
Settings → Host a server and share the address it shows; others add it
under Settings → Network → Preferred servers. See the
self-hosting guide.

What to try

• Text chat in a space and in DMs; send a DM while your friend is offline and
  see it arrive when they're back.
• Voice rooms with three or more people; leave as the host (the crown / radio
  icon) and check the others stay connected.
• Push-to-talk while another app is focused (Settings → Voice).
• Link a second computer (account menu → Link another device).
• Light/dark theme and accent colours (Settings → Appearance).

Found a problem? Open an
issue and attach
Settings → About → Copy diagnostics (it contains no messages). Report
security problems
privately.