/tidbyt-showcase

Content for the Tidbyt device https://tidbyt.com/products/tidbyt

Primary LanguageShellMIT LicenseMIT

tidbyt-showcase

Content for the Tidbyt device https://tidbyt.com/products/tidbyt


Logo

tidbyt-showcase

Background

I was fortunate enough to be gifted a Tidbyte the other day and started to kick the tires a bit. I quickly realized that creating apps for this little thing is pretty addictive. I started churning animations out to see what they would look like, and each one of them makes me smile every time they appear in rotation. Many of these graphics are not mine and the rights belong to the respective copyright holders. But have fun with them, open a PR if you would like to add to the library, but be respectful of content owners and people's general sensibilities, but most of all have fun.

Usage

There is a both a make file in the root and a script in the scripts directory that will install/remove the entire library on your device. After you run it apps will appear in the moble app and can be managed there. There is no magic here, it is a simple bash script that calls the pixlet utility to do the work.

1.👥 Clone the repository ( make sure to clone recursive, there are submodules )

git clone --recursive https://github.com/ScottDillman/tidbyt-showcase.git
  1. 📝 modify the device values and add your personal token
cd tidbyt-showcase
cp  ./scripts/env.sample ./scripts/.env
nano ./scripts/.env

Add your token and device ID to the .env file you created: (and no that is not a real token 🤦)

TOKEN="eyJhbGciOiJFUzI1NiIsImtpZCI6IjY1YzMu_GfP6aM-2DY6aILz5tJKZ-dFhMmUzNzodHRwczovL2FwaS50aWRieXQuY2JjZjljMTQ1MTQyNzk5ODZhMzYyNmQ1Y2QzNTI0N2IiLCJ0eXAiOiJKV1QifQ.eyJhdWQiOiJodHRwczovL2FwaS50aWRieXQuY_GfP6aM-2DY6aILz5tJKZ-dE29tIiwiZXhwIjozMjgzOTY3NTU0LCJpYXQiOjE3MDcxNjc1NTQsImlzcyI6Imh0dHBzOi8vYXBpLnwNWQifQ.mUG-duvz5WhfpqMuh3jCeRpZGJ5dC5jb20iLCJzdWIiOiJzTUZnMkNJdkl0UzJTSXJEZGpJRVN5YmN6aDAzIiwic2NvcGUiOiJkZXZpY2UiLCJkZXZpY2UiOiJvd2xpc2hs"
DEVICE="this-is-my-device-id"
  1. 🚀 Run the installer
make install

or

./scripts/tb-util install all

All images in the ./assets directory will be installed on your Tidbyt. If there are images you are not interested in just remove them or rename them so they don't have the webp extension and they will not be installed.

You can add or remove images from the assets directory and re-run the installer to add them to your Tidbyt. Just be sure they are 64x32 pixel webp images, and make sure they are named with only letters,numbers, and hypens. During install hyphens will be replaced with zeros to meet a requirement of Tidbyt apps.

  1. 😁 Have fun

Right now this is very bare bones and was about an evening's worth of playing around with the device. I plan to add things here and there to make the process of working with my Tidbyt easier. If you have ideas, suggestions, complaints, praise or want to make contributions just create an issue. Just remember this all for fun..

  1. 🗑️ Uninstall

Uninstalling all the images in the ./assets directory is easy with the following command:

make uninstall

or

./tb-util remove all

🤓 Advanced

You can also use the script directly to install/remove apps based on pattern matching using bash regular expressions. For example let's say you just want all the logos:

./tb-util install "^logo.*"

or maybe all the trippy apps:

./tb-util install ".*trippy.*"

or get real crazy and install only apps that have 2 and 4 versions 😜:

./tb-util install ".*[0]{2}[24]$"

You can pass scope regular expressions to both the install and remove commands.

There is also the none scope just to maintain symmetry with the all scope which just dumps out a list of currently installed apps to the command line and exits.

NB: I do not do any error trapping on API return values from pixlet, so you can ask it to remove apps that are not there, say for instance giving the install command an all scope when you only have one app installed. You will get the following warning:

WARN

This is completely harmless and can be ignored.

The mklst.abs file in the scripts directory can be ignored,it is just a simple ABS) script to generate the library section below. Why? because I'm lazy and automate everything I can.

👷Todo

  • Add more content of course 🥳
  • Change remove to only try to remove installed apps ( cleanup )
  • Whatever I can think of
  • Add a section on the animation file creation process and naming scheme
  • Maybe allow favorites?

Current library of images

Abstract

abstract-color-001 abstract-color-002 abstract-donut-001 abstract-spin-001 abstract-spin-002 abstract-spin-003 abstract-spin-004 abstract-trippy-001 abstract-trippy-002 abstract-trippy-003 abstract-trippy-004 abstract-trippy-005 abstract-trippy-006 abstract-trippy-007 abstract-trippy-008 abstract-trippy-009 abstract-trippy-010 abstract-trippy-011 abstract-trippy-012 abstract-trippy-013 abstract-trippy-014 abstract-trippy-016 abstract-trippy-017 abstract-trippy-018 abstract-trippy-019 abstract-trippy-020 abstract-wave-001 abstract-wave-002 abstract-wave-003 abstract-wave-004

Film

film-lotr-001 film-lotr-002

Games

games-sonic-001

Logo

logo-sega-001 logo-sega-002 logo-wittij-001

Metalslug

metalslug-D8hYXES-001 metalslug-boom-001 metalslug-elephant-001 metalslug-mummy-001 metalslug-mummy-002 metalslug-ufo-001

Misc

misc-bluefire-001 misc-coffee-001 misc-coffee-002 misc-duck-001 misc-eq-001

Os

os-c64-001 os-windows98-001

Tv

tv-botp-001 tv-cbs-001 tv-python-001

Building

The only time you really need to do this is if you add additional arguments with argbash and need to regenerate the script. Make changes to the ./src/tb-util.tpl template and run make build, the ArgBash CLI is required.

Proudly made using