Working on your Paratext projects
If your team works in Paratext, you do not have to move the project into Aquilla. The Aquilla desktop app can open the Paratext projects already on your computer, let you edit them, and write your changes straight back into the Paratext project folder. Paratext keeps doing what it does today: history, permissions and Send/Receive.
This page covers editing a book in place. To draft with AI, open the project in Aquilla with Open project instead; Link or import? compares the options, What is “This computer”? explains where the projects come from, and Send/Receive and Paratext’s memory explains how edits reach your team. Quick answers are in the Paratext FAQ.
Open a Paratext project
Section titled “Open a Paratext project”- Open the Aquilla desktop app. Choose This computer from the organization switcher, or from the link on the sign-in page if you have no Aquilla account.
- Choose Paratext projects.
- Aquilla lists the projects Paratext 9, Paratext 10 and Paratext Lite keep on this computer, with the name you are registered under in Paratext and whether Paratext is running right now.
- Choose a project. Its page shows its progress and its books, sorted into Not begun, In progress and Complete (see The project page).
- Pick a book. Each verse, heading and introduction paragraph becomes a line you can edit.
If your projects live somewhere unusual, choose Add a projects folder and give the full path of the folder (or of one project). Look again rescans the folders Aquilla already knows.
Edit and write back
Section titled “Edit and write back”Type your changes as you would anywhere else. The button at the top counts the changes you have not yet written (for example {count} changes to write). When you are ready, choose Write to Paratext. Discard changes throws away the edits you have not written yet.
Aquilla then:
- reads the book file again, so it works from what is on disk right now;
- checks that Paratext lets you edit this book and chapter (from the project’s user permissions);
- changes only the words you edited, leaving every other byte of the file exactly as it was — markers, footnotes, line endings and all;
- checks its own result before saving, and refuses to save if anything other than your edits would change;
- keeps a copy of the previous file outside the project folder.
After that, run Send/Receive in Paratext as usual. Your edits travel to the team like any other change.
Footnotes and cross references
Section titled “Footnotes and cross references”An edit that removes or adds a footnote or cross reference marker is held back, in case it was an accident. Aquilla shows which line it is and offers Write it anyway if you meant it.
Add notes for your team
Section titled “Add notes for your team”Each line has a speech-bubble button. It shows the notes you have already made on that verse in Paratext, and lets you add a new one. A note you add here is written straight into your Paratext notes file, so it shows up in Paratext’s Notes list and travels with Send/Receive like any other note.
- Aquilla writes only to your own notes file (the one Paratext keeps for the user registered on this computer), and only ever adds to it. Editing, replying to or resolving notes stays in Paratext.
- Only your notes are shown here. Notes from other team members are in Paratext.
- Before it saves, Aquilla checks that every note already in the file is untouched and that exactly one note was added. If that check fails, nothing is written.
When Paratext changes the same book
Section titled “When Paratext changes the same book”Aquilla watches the project folder while a book is open. Changes that arrive from Paratext or from Send/Receive show up on their own; nothing you have to do.
Paratext keeps open books in memory. If Paratext saves a book after Aquilla wrote to it, that save can put the old text back over your edit. Aquilla notices this, keeps your version, and asks you to choose:
- Keep mine or Take theirs, line by line, or for the whole book at once.
- The book is then on hold until you close or reload it in Paratext, otherwise the same thing would happen again. Choose I reloaded it in Paratext to continue.
Nothing is lost either way: both versions are shown side by side before you decide.
What Aquilla does not do
Section titled “What Aquilla does not do”- It never runs Send/Receive, and never touches the project’s history.
- It never creates books, renames files, or writes anything into the project folder other than the book you edited and your own notes file.
- It does not edit or resolve existing notes, and does not touch term renderings or project progress; those stay in Paratext.
If something goes wrong
Section titled “If something goes wrong”Every write keeps the previous version of the book file. On macOS these copies
are in Library/Application Support/com.frontierrnd.aquilla/paratext-backups/
inside your home folder; on Windows, in the app’s data folder under
paratext-backups. Each copy is named after the book file with the time it was
replaced. Paratext’s Project History also shows every change once it has
been through Send/Receive.
If Aquilla says it could not find who is registered in Paratext on this computer, open Paratext once and check that it is registered; Aquilla will not write to a project until it knows which Paratext user you are.
Help assistant
AI answers from the Aquilla docs — may make mistakes.