Thangamaana is a Tamil song. You'll also see it called Thangamaana Tamilan and தங்கமான தமிழன். My build plays that title as a 200-frame picture loop on a 0.96" SSD1306. The OLED shows the animation. It doesn't sing or play the track.
⬇ Free download, Thangamaana OLED code
You get the full main.ino with all PROGMEM frames · ZIP or git clone
Parts list
- Board: ESP32, or ESP8266 NodeMCU / Wemos with 4MB flash
- Display: 0.96" SSD1306 I2C OLED, 128×64, usually
0x3C - 4 Dupont wires (VCC, GND, SDA, SCL) for your connections
- A USB cable, plus the Arduino IDE on your computer
Connection / wiring
The sketch comment lists Uno pins (SDA A4, SCL A5), but you'll need an ESP board for this frame count.
| OLED pin | Arduino Uno / Nano | ESP8266 (NodeMCU) | ESP32 |
|---|---|---|---|
| VCC | 5V (or 3.3V if the module requires it) | 3.3V | 3.3V |
| GND | GND | GND | GND |
| SDA | A4 | D2 (GPIO4) | GPIO21 |
| SCL | A5 | D1 (GPIO5) | GPIO22 |
On ESP8266, call Wire.begin(4, 5) before display.begin() if the default I2C pins fail. If your screen stays black, try address 0x3D and read
OLED blank screen fixes.
Libraries
- Arduino IDE → Tools → Manage Libraries
- Install Adafruit SSD1306 first
- Install Adafruit GFX Library
- Select your ESP32 or ESP8266, set flash size to 4MB when that option exists, and pick your COM port
How the player works
Frames live in const uint8_t PROGMEM frameN[1024], and loop() steps the index every 149 ms:
void loop() {
static uint8_t frameIdx = 0;
static unsigned long lastMs = 0;
const uint8_t* frames[] = { frame0, frame1, /* ... */ frame199 };
const uint8_t numFrames = 200;
if (millis() - lastMs >= 149) {
lastMs = millis();
display.clearDisplay();
display.drawBitmap(0, 0, frames[frameIdx], 128, 64, SSD1306_WHITE);
display.display();
frameIdx = (frameIdx + 1) % numFrames;
}
}
Change 149 to speed the loop up or down. A smaller number gives you a higher frame rate (for example, 100 ≈ 10 fps).
Upload & run
- Open THANGAMAANA and download the ZIP, or clone it yourself
- The Arduino IDE wants the folder name to match the file, so rename your unzipped folder to
main, then openmain.ino - Install Adafruit GFX + SSD1306 if you haven't already
- Pick your ESP32 or ESP8266, flash size 4MB, and the COM port
- Click Upload and wait for it to finish
- Watch Serial at 115200. If you see
SSD1306 allocation failed, fix your power, wiring, or the I2C address
Ready to flash?
You can get the complete Thangamaana main.ino from GitHub now.
Make your own Tamil song animation
I exported this sketch from oledanimationmaker.com, and you can do the same:
- Open the free tool in Chrome or Edge, as I do
- Go to Import and drop in your short clip (up to 200 frames)
- Tune the threshold and dither, then check the live OLED preview
- Click Get the Code → Adafruit SSD1306 Arduino, and copy what you get
- Save the sketch, then push it to your own GitHub repo if you like
Related guides you'll want: Nazarome Chupale OLED, Video to OLED, PROGMEM flash limits.
Troubleshooting
- Sketch too big: 200 KB of frames needs an ESP32 or a 4MB ESP8266
- Blank OLED: use 3.3V on ESP, check your SDA/SCL, and try
0x3D - Folder name error: the file is
main.ino, so your folder must be namedmain - Slow / laggy: raise the 149 ms delay if your panel can't keep up
- No sound: this build is pictures of the Tamil song, not the audio
FAQ
Is Thangamaana a Tamil song?
Yes. The title is Thangamaana, and you'll also see people search Thangamaana Tamilan and தங்கமான தமிழன். This page is the OLED animation of that title.
Is the code free?
Yes, you can grab it free at github.com/itzmeAshish/THANGAMAANA.
Does it play the song audio?
No. It's a visual OLED animation. If you need the audio, add a speaker on its own circuit.
Build more OLED song animations
Import your clip, preview it on the OLED, and export Arduino code. It's free in the browser.
Open OLED Animation Maker →What the 200-frame Tamil sketch actually stores
itzmeAshish/THANGAMAANA
is the visual for the Tamil song Thangamaana. You'll find the same title searched as Thangamaana Tamilan and தங்கமான தமிழன். The sketch doesn't include the recording, a vocal track, or the words, so don't go looking for them. What you get is
frame0 through frame199: 200 PROGMEM bitmaps, 1024 bytes each,
drawn on a 128×64 SSD1306 at address 0x3C.
The file name is main.ino. After you download the ZIP, rename the folder to main so it matches. The IDE will refuse or rewrite a sketch whose folder is still THANGAMAANA or THANGAMAANA-main. It's the same main rule as the other repos that ship main.ino. Fix it first, before you decide the Tamil loop itself is broken.
setup() starts the panel and Serial at 115200. loop() waits 149 ms, clears, draws the current pointer with drawBitmap, calls display(), and wraps the index with modulo 200. There's no second mode, no brightness pot, and no "play once" flag. I kept it simple. You power it up and it loops.
Timing table from the 149 ms player
Do the sum: 200 × 149 ms = 29,800 ms, so one pass lasts about 29.8 seconds at roughly 6.7 fps. That pace sits between the very slow Kalayani step and the 15 fps Hindi loop. It's slow enough that you'll find a default 100 kHz I2C transfer (about 90 ms for 1024 bytes) usually finishes inside the delay, so it's forgiving.
| Delay you type | Approx. fps | Time for 200 frames | Practical note |
|---|---|---|---|
| 200 ms | 5 | 40 s | Easier for you to film, still a full pass of every bitmap |
| 149 ms (stock) | ~6.7 | ~29.8 s | The number in the published loop |
| 100 ms | 10 | 20 s | Snappier; fine if your module keeps up |
| 67 ms | ~15 | ~13.4 s | Likely bus-limited unless you raise the I2C clock |
Two hundred frames is also the top of what the video importer on this site will keep from a clip. If you rebuild Thangamaana yourself, you're already at that ceiling. Shorten your source if you need headroom for libraries on a smaller ESP module. You won't get a 201st array.
ESP wiring for a sketch that only mentions Uno in a comment
The comment's Uno map (SDA A4, SCL A5, 5V) documents the connector names. It isn't a suggestion to use an Uno for 200 KB of frames, so wire the board you'll actually flash.
- ESP32: connect SDA to GPIO21, SCL to GPIO22, VCC to 3.3V and GND to GND. That's the default I2C pair on the common DevKit. Don't look for A4/A5 labels, because they aren't on your board, and you shouldn't wire to them.
- ESP8266 NodeMCU: connect SDA to D2 (GPIO4), SCL to D1 (GPIO5) and VCC to 3.3V. If
begin()fails on a fresh core, callWire.begin(4, 5)first. A 4MB flash setting in Tools is part of the wiring job, because the binary won't fit a small profile, and you'll hit that error otherwise. - Modules with a regulator: many 0.96" boards tolerate 5V on Uno. On these ESP boards, stay on 3.3V anyway, since the MCU pins aren't 5V I2C pins.
200 KB, and the boards that can hold it
You're storing 200 × 1024 = 204,800 bytes of bitmaps, about 200 KB, plus Adafruit GFX, SSD1306, and the core. A classic Uno's entire flash is about 32 KB. The sketch isn't "a bit large." It's an order of magnitude past the chip, and you can't squeeze it in. Classic Nano matches the Uno. A Mega 2560's 256 KB flash is tight once the bootloader and libraries take their share, so I don't treat Mega as the target. I'd use an ESP32 or an ESP8266 with 4MB flash.
On ESP8266 you'll see a linker error about the sketch not fitting, or a flash size that still reserves a big filesystem. Pick a 4MB option that leaves you a megabyte or more for the sketch. Uploading a build with the wrong size can also boot-loop, even after a transfer that looks successful. If that happens, reselect the board, reselect 4MB, and upload again before you reseat the OLED.
Editing 149 when the loop feels rushed or sleepy
Change the literal in millis() - lastMs >= 149, and keep numFrames at 200. The modulo wrap is the whole repeat. If you pick a larger delay, the Tamil visual lingers. A smaller one plays the same 200 pictures in less than half a minute. Neither edit adds frames you didn't export, and neither adds sound. You can't fix that in code.
If you drop below about 90 ms and the pass no longer matches the table, your panel is spending the extra time inside display(). Wire.setClock(400000) after the bus starts is the lever you want. If a single frame looks torn, the clock is too aggressive for that module, or your wires are long. Go back to the default clock and use a 149 or 200 ms step. That's what I'd do. Torn frames aren't a reason to reorder frame0
through frame199.
Recording a full half-minute of the panel
I'd record about 35 seconds, a little longer than the 29.8 second stock pass. Fill the camera with the glass, kill reflections, and don't crop the phone video so hard that you slice off the last columns. You want to see motion through the whole window, then the opening picture again.
Silence is correct. Thangamaana on this OLED is pictures of the title's animation, not the Tamil audio. If you play the song from a phone beside the module, the 6.7 fps loop won't lock to the track, so treat them as two performances. A good recording of the display shows stable contrast (lit pixels stay sharp, the background stays black) and a clean return to the first frame. If you see flicker once per loop, always on the same bitmap, that array is a bad export. If it flickers the whole time, I'd look at power or the bus.
Failures that look like a bad display
- Black screen: check your 3.3V and GND first, then SDA/SCL. On NodeMCU, D1 and D2 are the pair you're most likely to swap. Your glass can be fine and still stay dark.
- Wrong address: If Serial prints
SSD1306 allocation failedat 115200, try0x3Dinbegin(). If 0x3C and 0x3D both fail, run a scanner later. Don't keep reinstalling Adafruit SSD1306, because the library is rarely the missing part. - IDE board mismatch: "ESP32 Dev Module" uploaded to an ESP8266, or the reverse, writes a binary the chip can't boot. Your OLED stays black because
setup()never runs. Match the board menu to your module, then the COM port. - Not enough flash: 200 KB of frames plus the core won't link for Uno, and it won't link for an ESP8266 you've left on a 512 KB or cramped 1MB setting. Set 4MB. If you need this visual on a small AVR, export fewer than about 15 full frames and accept a different loop.
- Folder name: if your IDE says the sketch must live in a folder named
main, it means exactly that. Rename the folder, because it isn't an OLED fault.
Bench questions for Thangamaana
Which song is on the OLED, and does it sing?
The title is the Tamil song Thangamaana, also looked up as Thangamaana Tamilan and தங்கமான தமிழன். Your panel shows the 200-frame visual only. There's no audio in the sketch.
I downloaded THANGAMAANA and Arduino wants a different folder. What do I rename?
Rename the folder to main, because the file inside is main.ino. Open main.ino from that folder. If you'd rather call it code.ino, rename the folder to code as well.
Will a slower delay make 200 frames fit on an Uno?
No. Delay changes time, not size. The bitmaps are about 200 KB and Uno flash is about 32 KB, so you'll want an ESP32 or a 4MB ESP8266.
How long should I record to prove the whole loop?
About 35 seconds at the stock 149 ms step, so the 29.8 second pass can finish and the first frame can return. If you record a short clip, you'll only see the opening bitmaps.
Related posts
Free tools: OLED Animation Maker for your SSD1306 and SH1106 animations, Assemble Studio for your name and logo animations, the Shadow Box Lamp Generator for your 3D-printed shadow lamps, Text to STL for your 3D-printed names and keychains, and 3MF to Web to show your 3D prints on any website. New: the Image to Byte Array converter, the OLED Robot Eyes generator and the Lithophane Maker. See all tools.