Skip to content

New Share your ideas with the AWTRIX community. Keep your creations together in your account.

Sign in

Which AWTRIX do you have? Choose it once and the Hub shows what runs on it.

ScriptAWTRIX NG

YearPixels

On an AWTRIX display
YearPixels shown on an AWTRIX display
YearPixels · by eliseo-juan

On your display

Your year at a glance: one pixel per day, two layouts, and fully customizable colors

Which AWTRIX do you have? See below where it runs, or choose your device.
Topic
Miscellaneous
Includes
Script

Runs on

  • Does not run on 32×8 (TC001 & DIY) Made for 52×16 (TC002).
  • Runs on 52×16 (TC002)
  • Does not run on 32×8 with AWTRIX 3 (TC001 & DIY) Made for AWTRIX NG.

Choose your display in the next step.

Send to AWTRIX

Choose your AWTRIX

YearPixelsAWTRIX NG script

Install this script on your AWTRIX NG. Its icons and sounds are installed with it.

Your AWTRIX’s local address, for example 192.168.178.39 or awtrix.local.

The name shown in your AWTRIX script list. Use letters, digits, hyphens or underscores.

Connection & device login

Connect your phone or computer to the same network as your AWTRIX. Allow local network access if your browser asks.

Use the device’s IP address, without a page path such as /#/apps.

If your AWTRIX requires a login, the username and password fields will appear when you connect.

Sign in to the Hub to install scripts. Attached files are installed separately.

Script description

See the whole year in a single glance. YearPixels gives every day its own pixel, with separate colors for past days, today, and the days still ahead.
Choose between two layouts:

  • Original: a continuous grid that fills from left to right, top to bottom.
  • Months: one row per month, from January at the top to December at the bottom. Each row contains exactly as many pixels as that month has days.
    Show the day counter and year percentage, keep just one, or hide both for a clean, automatically centered calendar.
    Features
  • Optional counter: day/total, day of the year, or days remaining.
  • Optional percentage: elapsed or remaining.
  • Separate color pickers for past days, today, future days, the counter, the percentage, and the background.
  • Automatic date changes and leap-year support.
  • Configurable appearance interval and time on screen.
  • Uses the clock's local date. No account, API key, external service, extra icons, or companion script required.
    Setup
  1. Install on a Ulanzi TC002 running AWTRIX NG (52 × 16).
  2. Open Apps, find YearPixels, and click its gear button.
  3. Choose your layout, indicators, and colors, then save.
    By default, YearPixels appears once after installation or a restart, then at the next rotation after 30 minutes have passed since its previous appearance. Set Appearance interval to 0 to show it on every rotation. This is an interval, not a schedule at fixed minutes of the hour.
    Display duration defaults to 0, which uses the device's global app duration. Set a value in seconds to override it for YearPixels.
    How to read it
    The default colors are amber for past days, warm white for today, and dim blue-gray for future days.
    For example, 298/365 means today is the 298th day of the year. The elapsed percentage includes today and rounds to the nearest whole percent. Days remaining excludes today. In the Months layout, the full day/total counter is split across two lines to fit.
    If the calendar shows the wrong date, check the clock's time zone and date/time settings. After changing the app's settings, it restarts and can appear once immediately.

More scripts in Miscellaneous

Something wrong with this script? Report it.