Biorhythms Plugin Documentation

Complete guide to installing and configuring the Biorhythms plugin for TRMNL e-ink displays

Get Started

๐Ÿš€ Quick Start

Get your Biorhythms plugin running in just 5 minutes with our Private Plugin setup.

โšก Fast Setup

No backend required - works immediately with direct URL access

๐ŸŒ Multi-Language

Supports English, Portuguese, Croatian, and Italian

๐Ÿ“Š Real-time Data

Live biorhythm calculations with interactive charts

Recommended: Start with Private Plugin for testing, then upgrade to Public Plugin to share with others.

๐Ÿ”ง Easy Installation

Setting up Biorhythms is simple! Just follow these three basic steps:

Good news: No technical setup required! The plugin works out of the box.
  1. ๐Ÿ“ฑ Add the Plugin

    In your TRMNL app, go to Plugins and search for "Biorhythms". Click Add Plugin.

  2. โš™๏ธ Configure Your Info

    Click the Configure button and enter:

    • Your birth date (format adapts to your language)
    • Your preferred language

    Date formats by language:

    • ๐Ÿ‡บ๐Ÿ‡ธ English: YYYY-MM-DD (like 1990-05-15)
    • ๐Ÿ‡ง๐Ÿ‡ท Portuguรชs: DD/MM/YYYY (like 15/05/1990)
    • ๐Ÿ‡ญ๐Ÿ‡ท Hrvatski: DD.MM.YYYY. (like 15.05.1990.)
    • ๐Ÿ‡ฎ๐Ÿ‡น Italiano: DD/MM/YYYY (like 15/05/1990)

    That's it! The plugin will calculate your personal biorhythms.

  3. ๐ŸŽฏ Add to Playlist

    Go to Playlists, add Biorhythms to your playlist, and it will appear on your TRMNL device!

๐ŸŽ‰ Done! Your biorhythms will update automatically throughout the day.

๐Ÿ“š About Biorhythms

The Story Behind Biorhythms

Biorhythms theory originated in the late 19th century with Wilhelm Fliess, a German physician, and was later popularized by Alfred Teltscher in the early 20th century. The theory suggests that our lives follow predictable cycles that influence our daily experiences.

โš ๏ธ For Entertainment Only: Biorhythms are a fun way to reflect on your daily patterns, but they lack strong scientific backing. Think of it as a playful tool for self-awareness, not a scientific prediction system.

The Three Classic Cycles

Traditional biorhythm theory focuses on three main cycles that start from your birth date:

๐Ÿƒ Physical (23 days)

Affects energy, strength, coordination, and physical well-being. High days may feel energetic, while low days might require more rest.

๐Ÿ’ญ Emotional (28 days)

Influences mood, creativity, sensitivity, and intuition. Emotional highs might bring creativity and optimism, while lows could feel more introspective.

๐Ÿง  Intellectual (33 days)

Impacts alertness, analytical thinking, memory, and concentration. Peak intellectual days might be great for problem-solving, while low days could favor more intuitive thinking.

How It Works

Each cycle follows a sine wave pattern, starting at zero on your birth date, rising to a positive peak, falling back through zero to a negative trough, and returning to zero. The cycle then repeats continuously throughout your life.

When cycles cross the zero line (going up or down), these are called "critical days" - traditionally thought to be times of transition or instability.

Modern Interpretation

Today, most people enjoy biorhythms as a form of entertainment and self-reflection. The patterns can be interesting to observe, but shouldn't be used for making important life decisions. It's more about having fun with personal rhythms than following strict predictions.

Date Format by Language

๐Ÿ‡บ๐Ÿ‡ธ English (en)

Format: YYYY-MM-DD
Example: 1990-05-15

๐Ÿ‡ง๐Ÿ‡ท Portuguรชs (pt-BR)

Format: DD/MM/YYYY
Example: 15/05/1990

๐Ÿ‡ญ๐Ÿ‡ท Hrvatski (hr)

Format: DD.MM.YYYY.
Example: 15.05.1990.

๐Ÿ‡ฎ๐Ÿ‡น Italiano (it)

Format: DD/MM/YYYY
Example: 15/05/1990

Supported Languages

๐Ÿ‡บ๐Ÿ‡ธ English (en)

Physical, Emotional, Mental

๐Ÿ‡ง๐Ÿ‡ท Portuguรชs (pt-BR)

Fรญsico, Emocional, Mental

๐Ÿ‡ญ๐Ÿ‡ท Hrvatski (hr)

Fiziฤki, Emocionalni, Mentalni

๐Ÿ‡ฎ๐Ÿ‡น Italiano (it)

Fisico, Emotivo, Mentale

Biorhythm Cycles

The plugin tracks three main biorhythm cycles:

  • Physical (23 days): Energy, strength, coordination, endurance
  • Emotional (28 days): Mood, creativity, sensitivity, intuition
  • Intellectual (33 days): Alertness, analytical thinking, memory, concentration

Date Format

Important: The date format automatically adapts to your selected language:

English: YYYY-MM-DD (1990-05-15) Portuguรชs: DD/MM/YYYY (15/05/1990) Hrvatski: DD.MM.YYYY. (15.05.1990.) Italiano: DD/MM/YYYY (15/05/1990)

๐Ÿ†˜ Troubleshooting

โฐ Quick Tip: Configuration changes may take up to 5 minutes to appear due to caching. Thank you for your patience!
Q: Plugin shows "Full view not available"
A: This usually happens when the plugin is first loading. Try refreshing the plugin in your TRMNL app. If it persists, check that your birth date uses the correct format for your selected language: English (YYYY-MM-DD), Portuguese/Italian (DD/MM/YYYY), or Croatian (DD.MM.YYYY.).
Q: I changed my birth date but it's not updating
A: The plugin caches data for 5 minutes to improve performance. Please wait up to 5 minutes for changes to take effect. You can also try a force refresh in the plugin settings.
Q: Chart is not displaying properly
A: Ensure your TRMNL device has internet connection for the chart library to load. Try restarting the plugin or performing a force refresh in your TRMNL app.
Q: The percentages seem wrong
A: Double-check your birth date is correct and uses the right format for your language: English (YYYY-MM-DD), Portuguese/Italian (DD/MM/YYYY), or Croatian (DD.MM.YYYY.). Remember that biorhythms are for entertainment and the patterns are based on mathematical cycles starting from your birth date.
Q: Plugin updates slowly or seems stuck
A: This is normal behavior! The plugin caches data for 5 minutes to reduce server load and improve performance. Your biorhythms will update automatically, but changes to settings may take a few minutes to appear.
Q: I can't find the plugin in the TRMNL store
A: Make sure you're searching for "Biorhythms" (with an 's' at the end). If you still can't find it, try refreshing the plugin store or checking if your TRMNL app is up to date.
๐Ÿ’ Thank You! We appreciate your patience as the plugin updates. Biorhythms are meant to be a fun, reflective experience - enjoy observing your personal patterns!
Still need help? Visit the GitHub Issues or join the TRMNL Discord community for support.

๐Ÿ’ Support the Project

If you enjoy using the Biorhythms plugin and would like to support its continued development, consider making a donation.

๐Ÿ™ Thank you! Your support helps keep this plugin free and maintained for the TRMNL community.

Bitcoin Donation

Scan the QR code or click the address to copy it:

Bitcoin QR Code

Scan with Bitcoin wallet

bc1q8wyhgagx542ngpkdd2sva3mjztumes8lhvhx3m
Click to copy address
โ‚ฟ

Every satoshi helps keep the biorhythms flowing! ๐ŸŒŠ