Goethe Write
EN

Chapter 17

Collaboration with Goethe Link

19 min readLast updated:

Some works are not written alone: an author and her editor, two screenwriters on the same script, a law firm on one brief, a director with her actors. Goethe Link connects Macs, iPhones and iPads so that several people can work on the same project. It needs no server of your own and no user account: a Mac that has the project open shares it, and the other devices join as guests. This chapter explains how you share, pair and join, how you write together, how you edit a screenplay as a team, and how people without Goethe read your work in the browser.

A connection between devices

The host is the Mac that has the project open. It holds the project's files and is the authority that decides. All other devices (other Macs, iPhone, iPad) are guests. They mirror the project on their device and write back over the connection.

There are two routes:

  • On the same network: two Macs in the office or at rehearsal connect over Wi-Fi or the network, with no Internet at all. A Mac is found on the network under a neutral name such as "Goethe-7F3A" (it changes with every start; the names of people or computers never travel over the network in the clear).
  • Over the Internet: you invite a person with a link. The connection runs through the Goethe Cloud, which only passes on encrypted messages.

A third, separate route exists for readers: the read link in the browser (see below).

End-to-end encrypted

Everything that runs between the devices is end-to-end encrypted. Names and texts travel over the network only encrypted. The devices exchange keys by an open procedure (X25519, HKDF-SHA256, ChaCha20-Poly1305); whoever records the network sees only ciphertext and the neutral name. On first pairing both sides compare six digits; if they match, nobody is in between. Because the procedure is openly described, any expert can check it.

Why this helps an author: an unpublished manuscript is valuable. With this design only the people you invited can read it, even when the connection runs over a stranger's Wi-Fi in a café.

Sharing belongs to Goethe Cloud, being a guest is free

  • Sharing (being the host, on the same network and over the Internet) belongs to the Goethe Cloud subscription. Without it the switch shows a calm row with the way to the purchase ("Sharing on the same network is part of Goethe Cloud.") instead of a switch that does nothing.
  • Being a guest is free. Whoever is invited needs no subscription and no account: "Whoever invites pays. Guests work according to their role, without a subscription of their own."
  • In a development build of Goethe Write everything is free; the lock exists only in the App Store version.

The App Store shows prices and terms under Goethe Write ▸ Purchase and Subscription; more in Chapter 18.

It can: write together (one person per text, in a screenplay one per paragraph), see the others' insertion points, Follow, "Everyone here", chat, comments and suggestions also from readers, rights per device and project, roles and sides, read links in the browser.

Coming soon: writing in the browser (today people only read and comment there), working at different times when the host's Mac is off (sync through the Goethe Cloud), and undo per entry on a guest (today a guest's text clears the undo history of that text on the host).

Sharing and pairing

Prerequisites

  1. The project must be saved. Choose File ▸ Save (⌘S). What is shared is the saved state; after every save the guests learn what changed. A project from another Mac that you opened yourself as a guest cannot be shared onward.
  2. You need the Goethe Cloud subscription (see above).
  3. The first time you share, macOS may ask about the local network. Allow it under System Settings ▸ Privacy & Security ▸ Local Network; otherwise no device finds your Mac.

When you turn sharing on, Goethe Write quietly makes a backup of the project before anyone else writes in it.

The "Collaborators" window

Click Collaborators in the toolbar. A small window opens. From top to bottom it shows:

  • the switches Share on the same network and Share over the Internet,
  • New Device with Pair Device…,
  • Invite (only while sharing),
  • Read in a Browser (read link),
  • Waiting to be compared and Wants to Open This Project, when devices are waiting,
  • Linked now: who is there, where and whether they write,
  • Taken Along, Paired, Not Connected Now, Messages and the button Everyone here.

The icon shows filled people as soon as sharing is on. New messages show as a small number at the icon.

Sharing on the same network, step by step

  1. Save the project (⌘S).
  2. Click Collaborators and turn on Share on the same network. Under the switch it says under which name your Mac can be found on the network ("Goethe-7F3A").
  3. Under New Device click Pair Device…. Pairing is open for two minutes, and a counter shows the time ("Pairing open, 1:42 left"). Close ends it sooner.
  4. On the other device choose your Mac (see the next section).
  5. Both devices show six digits. If they match, press They match on your Mac under "Waiting to be compared"; Reject turns the device away. Confirm on the other device too.
  6. The new device appears under Linked now. It reads only at first.

Comparison happens only the first time. A device that has been compared once connects afterwards without digits. It gets a project only if you have allowed it for that project.

Tip: pairing is open only while Pair Device… is pressed. Whoever knocks outside these two minutes does not even get as far as the digits.

Lock after wrong comparisons

Every begun comparison counts, also an abandoned one, until you have both said "They match". After three unconfirmed comparisons no new one begins for ten minutes; after that the wait grows. The button Pair Device… is then grey, and below it says: "Several comparisons did not match. Pairing works again from 14:30." This protects against someone standing in the middle trying out keys (see Chapter 25, "Connecting with other devices").

Rights per device and project

A device gets rights per project:

  • A newly paired device reads first.
  • A known device that did not have a project yet asks: under Wants to Open This Project three buttons appear: Allow to Read, To Write and Reject.
  • Under Linked now every person has a small menu at the end of the row that says "Reads" or "Writes". In it:
    • May Write switches writing on or off for this device in this project.
    • Follow or Stop Following (see "Writing together").
    • Role and Sides as PDF (see "Screenplay in a team").
    • Disconnect ends the connection to this device; a text it was writing in is free again. That is the way out when a device went away without saying so.
    • Unpair forgets the device completely. It has to be compared again afterwards.
  • Under Paired, Not Connected Now stand devices that are allowed but not there, with the date "Paired since …" and the same menu.
  • Taken Along: a device can take a text along and write it on the way, even without a connection. Meanwhile it is read-only on your Mac. Restore gives it back; what the device wrote in the meantime arrives as "not delivered".

Example: Your editor gets "Allow to Read" for the novel. For the conversation about chapter 7 you switch on May Write for her. Afterwards you switch it off again.

For people who are not on the same network:

  1. Turn on Share over the Internet. If the service is reachable, it says below "Reachable over the internet for everyone you invite."
  2. Under Invite click Invite to Read or Invite to Write.
  3. Goethe Write makes a link (it begins with goethe-link://), puts it on the clipboard and shows it, with Copy and Share…. If the Mac is still waiting for the service, it says "Connecting to Goethe Cloud. The link follows as soon as this Mac is reachable."
  4. Send the link to the person you mean.

The link works once and for seven days. Whoever opens it joins without comparing digits, so send it only to the person you mean. Open invitations stand below ("To Write, valid until …"); Withdraw makes them unusable. The link names neither a person nor a project. If the project's place in the Goethe Cloud was already taken, it gets a new place and earlier links no longer apply.

Coming soon: The service for the Internet (the relay of the Goethe Cloud) is not yet in operation. Until then it says "The internet service is not reachable right now. Goethe Write keeps trying; in the same network it works without it." See the last section.

Ending sharing

Switch Share on the same network (and Share over the Internet) off again. Goethe Write tells the guests, closes the connection and frees every text. If you close the project window, sharing ends as well.

Opening from the network (guest)

Joining as a guest

  1. Choose File ▸ Open Project from Network… (⌥⌘O). The window "Open Project from Network" searches ("Searching…") and lists the hosts under "Macs with Goethe Write in This Network".
  2. On the other Mac sharing must be running and Pair Device… open (the window tells you: "On the other Mac: open the project, then “Collaborators”, “Share in This Network” and “Pair Device…”."). There stands the name that appears here.
  3. Click Connect beside the name.
  4. The first time, Compare Digits appears with six large digits. If the other Mac shows the same, nobody is in between. Press They match (and on the other Mac too). Cancel cancels.
  5. If your Mac is known but the project is new, it says "Waiting for the other Mac to allow this project for this Mac." until the host chooses Allow.
  6. Goethe Write fetches the project ("Fetching the project: 3 of 12 files") and opens it ("Opening the project…"). The window closes.

With an invitation over the Internet: click the link (it opens Goethe Write), or paste it in the window under "With an invitation over the Internet" into the field Paste invitation link and press Join. If the text is not an invitation link, it says "That is not a Goethe Write invitation link. It starts with “goethe-link://”."

How a guest project works

A project you have open as a guest behaves like this:

  • Nothing is saved on your Mac. The host holds the project. The mirror lies in the folder "Goethe Link" in Application Support on your Mac; it opens only through the guest access. Opened through "Open Recent", it is only a copy to read, never saved.
  • The outline and the knowledge belong to the host. Moving, renaming and changing facts is the host's job; you get a sentence in the line under the middle: "As a guest you write only in the text you hold. … changes the outline and the knowledge."
  • You may write only in the text you currently hold (and only if the host has given you "May Write"). When you open a text, Goethe Write asks the host for it. All other texts are open to you for reading.
  • Pictures in shared texts are inserted by the host. You can read and comment on texts with pictures.

The line under the middle always tells you where you stand, for example:

  • "Guest of Anna: reading. Anna can allow writing."
  • "Guest of Anna: you are writing here, the others read along."
  • "Nami is writing here. You are reading along."
  • "Asking Anna for this text…"

A symbol to the left of the line shows the state: two people (connected, writing), an eye (reading), arrows (connecting), a struck-through Wi-Fi sign (disconnected).

When the connection breaks

If the connection breaks, everything becomes read-only. Goethe Write reconnects by itself, but only with exactly this host (with the key of its device; any other Mac on the network ends the connection before digits appear). The line says: "Connection to Anna lost. Goethe Write reconnects as soon as Anna is reachable; until then read-only." You can also press Reconnect in the Collaborators window, or end it yourself with Detach.

What you have written is never lost silently:

  • Every text you send is answered (accepted or refused, with a reason). What stays unanswered lies in an outbox on your Mac, survives interruptions and is sent again after reconnecting. A count "Not confirmed yet: 2" shows it.
  • It never goes over a version that someone else has changed in the meantime. Then it says "… changed on Anna while your text was on its way. Your text is kept." and a button Copy puts it on the clipboard; Discard… deletes it after a question ("It did not reach … and exists only here. Once discarded, it is gone; you can copy it first.").

Writing together

One person per text

In a text only one person writes at a time; the others read along. Whoever begins to write in a text borrows it: a guest opens the text, asks the host for it, and if it is free it is theirs until they give it back.

On the host you see who writes where:

  • Line under the middle: "Nami (iPhone) is writing here. Meanwhile the text can only be read on this Mac." With several: "Others are writing: … Meanwhile these texts can only be read on this Mac."
  • Sidebar: a person symbol at the entry shows who is in this text; when you point at it, it says "Here: Nami (iPhone)".
  • Text: the others' insertion point stands as a line in their colour in the text, with the name in the margin. This holds for Mac, guest Mac, iPhone and iPad.

If you write on the host's Mac yourself, a text you touched stays yours for twelve seconds after your last key; only then can a guest borrow it. While a guest writes in a text, it cannot be edited on your Mac. If you try anyway (through Goethe, Replace All or a snapshot), the change is taken back at once, with a sentence: "Nami is writing in this text right now. You can accept or reject changes in it once it is free again."

Before a new person begins to write in a text, Goethe Write makes a snapshot: the text as it was before stays preserved.

Follow and "Everyone here"

  • Follow: in a person's menu choose Follow. Wherever they go, your window goes with them, but never in the middle of a word. Under the middle it says "You are following Nami." with Stop Following. Moving on your own ends following.
  • Everyone here: the button in the Collaborators window opens, for everyone connected, whatever is open on your Mac. Whoever is writing is not torn out of the writing: for them it says "Nami is calling everyone to “Chapter 7”." with Jump and Later.

Example: In the meeting you say "Everyone to chapter 7" and press Everyone here. On three devices chapter 7 is open.

The chat

Under Messages you write to everyone connected. The host names the sender; the chat shows the last eight lines, the session keeps 300, and whoever joins gets them. A new message shows a number at the Collaborators icon and a sentence in the line under the middle. The chat is end-to-end encrypted too.

Comments, replies and suggestions

Even those who may only read can contribute:

  1. Comment: select a passage, open the context menu and choose Comment. A sheet asks for the words; Send sends them. On the host the comment appears at the passage, in the person's name. If the passage has moved meanwhile, Goethe Write finds it again; if not, "(The passage had changed.)" stands in front.
  2. Suggest Change…: select the passage, choose Suggest Change…, change the wording in the sheet, Suggest. On the host the new words stand behind the old ones, both as a tracked change in the person's name. You accept or reject them like any tracked change. Whoever may write simply changes the text ("You are writing in this text: just change it.").
  3. Replies: every guest can reply to a comment; the reply shows at once for them and is held by the host.
  4. Done: whoever may write can mark a comment as done. Otherwise it says "Only people who may write can mark it done. … can allow that."

Without a connection comments and suggestions wait and go out the next time you connect. A reply stays in its field until the connection is there.

How comments and tracked changes are handled on the host is explained in Chapter 11.

Screenplay in a team

Lent paragraph by paragraph

A screenplay can be written by several people at once, even in the same scene. Lending is per paragraph:

  • Each person writes in the paragraphs they hold. New paragraphs after their own belong to them until they are sent.
  • A guest keeps typing in a free paragraph at once; the text goes out as soon as they move.
  • Every paragraph held by someone else carries a coloured bar with the person's name at the left margin of the page; the bar stands on the desk beside the page, never over the text.
  • On the host it says under the middle: "Nami in “INT. KITCHEN - DAY”. On this Mac these scenes are read-only meanwhile." On the guest: "Guest of Anna: you write the screenplay together, each person in their own paragraph." and, when a paragraph is taken, "Nami is writing in this paragraph. You are reading along."
  • A paragraph you want to delete or merge with the next is yours only if you hold both. Otherwise the change did not stay: "Nami is writing in the next paragraph. This change was not kept."

Drafts, idea and beats are changed by the host; as a guest you write in the scene you hold.

Why this helps: in a writers' room two people often write at once in the same scene, one the action, the other the dialogue. Each person holds their paragraphs, nothing is overwritten.

Roles and sides

The director assigns a device roles:

  1. Click Collaborators.
  2. At the person open the menu "Reads" or "Writes" and choose Role, then the character. Several characters are possible.
  3. Everyone sees who plays whom: "Role: LARA".
  4. Sides as PDF sets all scenes in which the role speaks as a screenplay PDF. This works on a guest Mac too, if it has a role.

On the iPhone the companion app shows the scenes and lines of one's own role with "My Sides". The screenplay itself is covered in Chapter 9.

A read link shows people without Goethe your manuscript and screenplays in any browser, also on Windows and also while your Mac is off.

Prerequisite: the Goethe Cloud subscription and a saved project.

  1. Click Collaborators. The section Read in a Browser appears.
  2. Decide whether readers may comment: switch Readers may comment.
  3. Click Create Read Link. Goethe Write encrypts a state of the project and uploads it to the Goethe Cloud.
  4. The link stands there: https://goethecloud.com/read/#s=…&k=…. Copy puts it on the clipboard; Share… opens the Mac's share menu.

The key stands only in the link, behind the "#". No browser sends that part to a server. The Goethe Cloud holds only ciphertext and cannot read it. Whoever has the link reads; so send it only to those who should read.

Keeping it up to date

  • After every save Goethe Write uploads the new state, at most every two minutes. The section shows "As of …" or "Uploading…". Update Now sends at once.
  • Your Mac fetches the comments from the browser every two minutes while the project is open. New ones show as "New comments from the browser: 2".
  • Space: each owner has at most 1 GB in the Goethe Cloud. If it is full, it says "Your space in the Goethe Cloud (1 GB) is full. Withdraw another read link."
  • If the Goethe Cloud is not reachable, it says the read link shows the last state.
  • When the subscription ends, the link shows the last state, comments keep arriving, but no new state goes up.

What readers see

Readers open the page goethecloud.com/read/ with the link. The browser decrypts the project itself. They see:

  • a bar at the top with Contents (the outline of the manuscript and the Screenplays), below it the project's title with "As of …" and the date,
  • the text, for a folder its texts one after another, screenplays as screenplays, with Previous and Next at the end,
  • at the bottom the line "Read-only copy · end-to-end encrypted".

A text appears as paragraphs with bold, italic and underline. Fields show their value; a footnote mark or a picture does not appear.

If commenting is allowed, readers can:

  1. select a passage ("To comment on a passage, select it.") or comment on the whole text with "Comment on this text",
  2. choose Comment, enter their name and write the comment,
  3. press Send.

The comment is encrypted in the browser before it goes out ("Your comment is encrypted in this browser before it is sent."). Your Mac fetches it: it becomes a comment of the project in the reader's name, at the place where it was written. The reading page follows the language of the browser (German, otherwise English).

Withdrawing

Withdraw deletes the state and the comments in the Goethe Cloud; the link then opens nothing. The link is forgotten on your Mac only once the service has confirmed it. If it did not go through, it says "The read link could not be withdrawn just now and can still be read. Try again in a moment."

Example: You send your publisher in Zurich the read link to chapters 1 to 5. He reads in the browser, selects a paragraph and writes "I miss the motivation here." The next morning the comment stands in your manuscript, with his name.

Coming soon: Internet relay

Coming soon: Sharing over the Internet and read links run through a service of the Goethe Cloud, the relay. This service is not yet in operation. Until then everything works on the same network; over the Internet the app honestly shows that the service is not reachable ("The internet service is not reachable right now …").

What then works in addition is already in the app: the switch Share over the Internet, the invitation links (valid once, seven days, withdrawable) and the read link. As soon as the service runs, you need to change nothing.