https://github.com/nicholaswilde/trmnl-google-sheet-quote
🖼️ A private plugin for TRMNL to display quotes from a Google Sheet 📊
https://github.com/nicholaswilde/trmnl-google-sheet-quote
gsheets trmnl-plugin
Last synced: 4 months ago
JSON representation
🖼️ A private plugin for TRMNL to display quotes from a Google Sheet 📊
- Host: GitHub
- URL: https://github.com/nicholaswilde/trmnl-google-sheet-quote
- Owner: nicholaswilde
- License: apache-2.0
- Created: 2025-07-17T19:52:48.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2026-01-31T08:11:30.000Z (4 months ago)
- Last Synced: 2026-01-31T18:46:03.202Z (4 months ago)
- Topics: gsheets, trmnl-plugin
- Language: Liquid
- Homepage: https://trmnl.com/recipes/121258/
- Size: 422 KB
- Stars: 2
- Watchers: 0
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# :framed_picture: TRMNL Google Sheet Quote :bar_chart:
A private plugin for [TRMNL](https://trmnl.com/) to display quotes from a Google Sheet.
## :rocket: Features
- Displays a random quote from a Google Sheet.
- Customizable polling interval to fetch new quotes (default: 1 hour).
- Configurable columns for quote and author.
- Robust error handling with on-screen feedback.
## :hammer_and_wrench: Installation
1. Clone this repository to your local machine.
2. Copy the `src` directory to your TRMNL plugins directory.
3. Rename the `src` directory to `sheet-quote`.
## :gear: Configuration
Configuration is handled within the TRMNL application. After installing the plugin, you will find the following settings:
- **Spreadsheet ID**: The ID of your Google Sheet.
- **Quote Column Index**: The column number (starting from 0) for the quotes in your sheet.
- **Author Column Index**: The column number (starting from 0) for the authors in your sheet.
For more detailed instructions, please see the [TRMNL documentation](https://help.usetrmnl.com/en/articles/11400219-using-google-sheets-with-private-plugins).
## :question: Troubleshooting
If you see "No data found" or the plugin is stuck on "Loading quote…":
1. **Check Spreadsheet ID:** Ensure the ID is correct and the sheet is shared with "Anyone with the link" (Viewer access).
2. **Check Logs:** In the TRMNL dashboard, go to the **Logs** tab for this plugin. Look for "Sheet Quote: Starting execution" to verify the script is running.
3. **Error Messages:** The plugin displays specific error messages on the screen if data is missing or malformed to help you debug.
## :construction: Development
This project does not have any dependencies to install or a development server to run. The plugin is designed to be used within the TRMNL application.
To make changes, edit the files in the `src` directory. The `.liquid` files control the layout, and `settings.yml` controls the configuration options.
## :balance_scale: License
This project is licensed under the Apache License 2.0. See the [LICENSE](LICENSE) file for details.
## :pencil: Author
This project was started in 2025 by [Nicholas Wilde][2].
[2]: