Skip to content
Oleaflyv0.4.12

See who is in a shared project, follow their cursors, jump to a collaborator, read the sync status, chat with the project, and compile matching PDFs.

In a shared project, everyone types into the same files at once. Edits merge as you type, so two people can work in the same paragraph. You never press save or send.

The avatars on the toolbar are the people in the project right now. Hover over one to see the person’s name, their role and the file they have open. A guest also has a Guest badge. When more people are here than fit, a number stands in for the rest. Hover over it for the list.

The People section of the Live collaboration pane lists everyone in the project, you first. Under each name you see their role and where they are:

  • Here now in a file path: they’re in the project with that file open.
  • Here now: they’re in the project, but not in a file.
  • Not here right now: they don’t have the project open.

In the Explorer, a small dot in a person’s colour sits beside each file they have open. Hover over the dot to see who it is.

Each person has their own colour. Their cursor shows in the editor as a thin line with their name above it, and the text they select is tinted in their colour. You see these only in the file you have open, and only for people who share their cursor.

Each person chooses what others see under What others see in Settings → Collaboration. Read Choose what others see.

Select a person’s avatar on the toolbar, or their row under People, to go to where they are. Oleafly opens their file, scrolls to their cursor and tints the line in their colour for a moment. Your own cursor and selection stay where they were in that file, so you don’t lose your place.

When someone isn’t in a file, their avatar says “Not in a file, so there is nowhere to go”, and selecting it does nothing.

The icon at the top of the Live collaboration pane, beside Manage sharing, shows whether your work has reached everyone. The tooltip on the toolbar’s Share button shows the same status. Hover over the icon or select it for details: the server’s name and address, your role and how many changes are waiting.

StatusWhat it means
Up to dateThe server has all your changes, and you have everyone else’s.
SyncingChanges are on their way.
Offline. Changes waiting: and a numberThere’s no connection. That many changes wait on this computer and go out when you reconnect.
ReconnectingThe connection dropped, and Oleafly is trying again. Nothing of yours is waiting.
Signed outThis computer is signed out of the server. Select Sign in. Your changes stay on this computer.
Account suspendedAn admin suspended your account. Your changes stay on this computer, and you can sign in again once it’s turned back on.
No accessYou no longer have access to the server. Your copy stays on this computer.
Access removedThe owner removed you from the project.
Sharing stoppedThe owner stopped sharing the project, or an admin archived it.
PausedSyncing stopped on this computer. It starts again the next time you open the project.

When your access changes covers the last few in detail.

Sync status changesUp to date changes to Syncing when you or others edit, and back to Up to date when all changes are through. When the connection drops, the status becomes Reconnecting, and Offline with a count of waiting changes once you keep typing. When the connection is back, it becomes Syncing. Six other statuses mean syncing has stopped: Signed out, Account suspended, No access, Access removed, Sharing stopped and Paused.Syncing stopsUp to dateSyncingReconnectingOfflineChanges waiting: NYou or others editAll changes throughConnection dropsor comes backYou keep typingConnection backSigned outAccount suspendedNo accessAccess removedSharing stoppedPausedSync status changesUp to date changes to Syncing when you or others edit, and back to Up to date when all changes are through. When the connection drops, the status becomes Reconnecting, and Offline with a count of waiting changes once you keep typing. When the connection is back, it becomes Syncing. Six other statuses mean syncing has stopped: Signed out, Account suspended, No access, Access removed, Sharing stopped and Paused.Syncing stopsUp to dateReconnectingOfflineChanges waiting: NSyncingConnection dropsYou keep typingConnection backAll changes throughSigned outAccount suspendedNo accessAccess removedSharing stoppedPaused
How the sync status moves while you work, and the statuses that mean syncing has stopped.

Undo takes back only your own edits. If a co-author typed in the same paragraph, their text stays where it is.

The Activity section of the Live collaboration pane keeps a short history of the project:

  • people opening and closing the project, joining it and leaving it
  • people added to or removed from the project, and changes to your role
  • going offline and coming back, and how many changes from others were merged while you were away
  • someone in the project signing in on a new device
  • a rename of yours that crossed with someone else’s rename of the same file
  • someone mentioning you in a comment, with Show comment

A merge entry has Show files to list the files that changed. Review opens a read-only view of those changes, grouped By person and By file.

Chat on the project rail opens one conversation for everyone in the project. It suits things that aren’t about one passage, such as who takes which section. For a remark about specific text, add a comment instead.

  • Write in the Message box and select Send. Owners, editors, reviewers and commenters can post. Viewers can read the chat but not post in it.
  • You can post only while the project is connected. Offline, the chat says “This project isn’t connected right now, so you can’t post.”
  • A dot on the Chat icon means someone posted while you had the chat closed.
  • Show older messages at the top brings back earlier ones.
  • To delete a message you wrote, select Delete message on it. It’s deleted for everyone, and “This message was deleted.” takes its place.
  • The owner can remove every message with Clear chat. That can’t be undone.

Like comments, the chat stays with the shared project. It never goes into your files.

Each person compiles on their own computer, and the build files stay there. When an owner or editor compiles successfully, Oleafly also sends the new PDF to the server, at most once a minute. People who open the project in a browser read that PDF.

The project’s compile settings are shared, so they’re the same for everyone: the main document, the compiler, the spelling language, and for Typst projects the Typst version, fonts and build options. When someone changes one of them, everyone’s copy follows and Activity says who changed what. If someone renames or moves the main document, it stays the main document. Only owners and editors can change these settings. Reviewers, commenters and viewers see them greyed out.

Each person still needs that engine on their own computer, or uses the one bundled with Oleafly. Choose an engine explains the options.

Allowing external commands, also called shell escape, isn’t shared. Each person decides it for their own computer. Before turning it on, Oleafly warns you that anyone who can edit the project could then run programs on your computer when you compile. Read Allow external commands.

If people compile with a system TeX installation, small differences between installations can still change the PDF. Keep everyone’s TeX at a similar version.

The PDF comes from the files as they are, so it includes any suggestions still waiting for review. Oleafly tells you how many there are when you compile. What’s in the file explains why.

Export works the same as in any project. It uses the files on your computer, which match everyone else’s once your status says Up to date.

Image preview

AI answers couldn’t load

Try again, or search the documentation.