AM7XXX-PLAY(1)

🌸 AM7XXX-PLAY 💖

okay bestie, so am7xxx-play is a section-1 manual page and it's literally the whole guide to yeeting pictures and videos onto a tiny projector, no cap. sit down, grab a strawberry drink 🍓, and let's go.

---

✨ NAME ✨

am7xxx-play — play stuff on an am7xxx device (e.g. Acer C110, PicoPix 1020)

like, "play stuff". that's the job. iconic behavior honestly. 🫶

---

🎀 SYNOPSIS 🎀

am7xxx-play [OPTIONS]

that's it. that's the whole thing. drop some options in and let her cook. 💅

---

🌈 DESCRIPTION 🌈

so here's the tea: am7xxx-play(1) pulls in libavdevice, libavformat, libavcodec and libswscale to decode whatever you throw at it, then encodes it to jpeg, and then shows it off using libam7xxx. decode ➡️ encode ➡️ display. the full glow-up pipeline, periodt. ✨

---

👑 OPTIONS 👑

so many little knobs. she's high maintenance but worth it. 🙈

• -d <index> — the device index, and yes, the default is 0 (first one, main character energy).
• -f <input format> — the input device format.
• -i <input path> — the input path.
• -o <options> — a comma separated list of input format options.

EXAMPLE:

-o draw_mouse=1,framerate=100,video_size=800x480

• -s <scaling method> — the rescaling method (see swscale.h, iykyk).
• -u — upscale the image if it's smaller than the display dimensions. lil picture, big screen, we love a growth arc. 🦋
• -F <format> — the image format to use (default is JPEG).

SUPPORTED FORMATS:

• 1 - JPEG
• 2 - NV12

• -q <quality> — quality of jpeg sent to the device, between 1 and 100.
• -l <log level> — the verbosity level of libam7xxx output (0-5).
• -p <power mode> — the power mode of device, between 0 (off) and 4 (turbo). 🚗💨

WARNING: Level 2 and greater require the master AND the slave connector to be plugged in. like BOTH of them. do not skip this, bestie, it will simply not work. 😭

• -z <zoom mode> — the display zoom mode, between 0 (original) and 4 (tele).
• -h — show the help message. your friend when you're lost. 🧚

---

🔥 EXAMPLES OF USE 🔥

copy-paste these, they're certified slay:

am7xxx-play -f x11grab -i :0.0 -o video_size=800x480
am7xxx-play -f fbdev -i /dev/fb0
am7xxx-play -f video4linux2 -i /dev/video0 -o video_size=320x240,frame_rate=100 -u -q 90
am7xxx-play -i http://download.blender.org/peach/bigbuckbunny_movies/BigBuckBunny_640x360.m4v

that last one is literally big buck bunny streaming from the internet straight to your tiny projector. the way that works?? obsessed. 🐰💖

---

💀 EXIT STATUS 💀

• 0 — Success. we ate. 🔥
• !0 — Failure (libam7xxx error; libav error). not the vibe. check ya logs. 😭

---

🌸 AUTHORS 🌸

Antonio Ospite and Reto Schneider. absolute legends, ty for your service. 🫶

---

⭐ RESOURCES ⭐

Main web site: http://git.ao2.it/libam7xxx.git — go look, it's right there.

---

💜 COPYING 💜

Copyright (C) 2012-2014 Antonio Ospite <ao2@ao2.it>

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

like, free software fr fr. share it, remix it, keep it open. that's the whole point. 🌈

---

and that's the page!! 🎀 this was version AM7XXX-PLAY(1) dated 12/31/2025 — go forth and project something cute onto a wall, bestie. slay. 💅✨