Teleprompter that imports Google Docs
NinjaPrompter is an iPhone teleprompter that imports scripts from Google Docs to your iPhone. When you refresh from the Doc later, the app compares the Doc with a stored copy and replaces nothing until you choose to.
How do I import a Google Doc?
Tap Import Google Doc in the library, pick one Doc, choose a tab if the Doc has several, then tap Save on the review screen.
- Pick the Doc. Google's sign-in, permission, and picker screens open in a system web sheet. The picker shows Google Docs and lets you pick one at a time. Every new import goes through this step, so you choose the Doc each time.
- Choose a tab. If the Doc has several tabs, a Choose one tab list comes first. A Doc with one tab goes straight to review.
- Review and save. Before anything is saved, the review screen shows the copy: a title you can edit (it starts as the Doc's title), the Doc and tab, Conversion notes on what was flattened or left out, and a preview of the text. Tap Save to keep it.
Conversion notes are short messages on the review screen about what the copy leaves out or changes. Every Google import shows these two:
- "Only committed body text is imported. Suggestions and comments are not included."
- "Headers, footers, footnotes, images, and embedded objects are outside the reading copy and are omitted when present."
Others appear only when the Doc has that content, for example "Table text was flattened in row order." The notes don't stop you from saving.
If you cancel at any point, or back out of Google's sheet, nothing is saved. A saved script is a copy on your iPhone.
What access does NinjaPrompter ask Google for?
NinjaPrompter only sees the Google Docs you pick in Google's picker. It can't see, list, or open any other file in your Drive.
NinjaPrompter only reads the Doc and never creates, edits, moves, or deletes a file. The text goes from Google straight to your iPhone, not through a NinjaPrompter server. The sign-in tokens are stored securely in the iOS Keychain on your iPhone.
To remove access, tap Disconnect Google in Settings. The app deletes the tokens and asks Google to revoke the access. You can also remove it at myaccount.google.com/permissions. Scripts you already imported stay on your iPhone. The privacy policy has the details.
How do Google Docs tabs import?
Each import brings in one tab. In the tab list, nested tabs show their full path, such as Act 2 › Scene 1, with parents before children. A tab without a title shows as Untitled tab.
The script remembers the tab by its ID, so renaming the tab doesn't break a refresh. If the tab is deleted, the refresh stops with a message instead of reading another tab. To use another tab, import the Doc again and pick that tab. Each import becomes its own script.
What formatting carries over?
NinjaPrompter imports headings, bold, italic, lists, and table text. The app does not import special fonts, sizes, colors, images, or anything outside the body text.
| Imported | Left out |
|---|---|
| Title, Subtitle, and Heading 1 to 6 | Fonts, sizes, colors, underlines, and highlights |
| Bold and italic, including from a paragraph style | Links (the link text stays) |
| Lists, as lines starting with their bullet or number, indented two spaces per level | Images, embedded objects, equations, and chips |
| Tables, flattened to one line per row with a tab between cells | Headers, footers, and footnotes |
| Page breaks, column breaks, and horizontal rules, as line breaks | Comments and pending suggestions |
The app imports the text as is, without suggestions applied. Headings, bold, and italic are saved with the text, and you can switch them on and control their look and feel in the NinjaPrompter Reading settings.
One limitation is that NinjaPrompter only supports scripts up to 100,000 characters long (~17,500 English words on average). If the app runs into something it can't read reliably, it imports nothing rather than part of the tab, and tells you why. If the app can't recognize and resolve formatting options in your scripts, the formatted text is imported as plain text.
How does refresh work?
Open the script and tap Refresh from Google Docs. The app saves your current edits, reads the same Doc and tab again, and compares them with your copy. Nothing changes until you decide. If the saved access has expired or you disconnected Google, the button reads Reconnect to refresh instead, and it reopens Google's picker for the same Doc.
| The Doc | Your copy | What happens |
|---|---|---|
| Unchanged | Unchanged | "Text and formatting match Google Docs." |
| Unchanged | Edited | "No changes in Google Docs. Your local edits are preserved." |
| Changed | Unchanged | A review shows the new version, with Replace local copy or Cancel. |
| Changed | Edited | A review shows the new version under a You have local edits warning, with three choices. |
When both have changed, the three choices are:
- Import as new script saves the Doc's version as a separate script with "— new copy" added to its title, and leaves your edited script as it is.
- Replace local copy asks you to confirm, then discards your text and formatting edits. It keeps your title and reading preferences. If the text changed, the script starts again from the beginning. If only the formatting changed, it keeps your place.
- Cancel leaves your script as it was.
Each successful check updates the Last checked time on the script.
What if an import or refresh fails?
Nothing changes. NinjaPrompter doesn't save partial imports, and a failed refresh leaves your script as it was. The app tells you why, and some reasons include: no connection, a Doc or tab that was deleted, Google refusing or limiting requests, expired access, and a tab that's empty or over 100,000 characters.
If an import fails, simply try again to fetch the Doc you picked without reopening the picker, as long as your access is still valid. Choose another Google Doc starts over. After a failed refresh, tap Refresh from Google Docs again. A failed refresh doesn't change the Last checked time.
Is Google Docs import free?
Yes. Importing and refreshing Google Docs works during the 7-day trial, on the free plan, and with a subscription. On the free plan, a locked script can't be refreshed until it's active again. The support page explains the free plan.
NinjaPrompter also imports .txt and .md files.
Google Docs is a trademark of Google LLC. NinjaPrompter is not affiliated with Google.