Curses Cam

2016-08-27, post № 139

curses, programming, Pygame, Python, #camera, #color depth, #low resolution, #shell image, #.si, #text-based images

Normally a shell lets you input via a text command and outputs via a text message [1]. When using curses you can extend its capabilities and program for example games with limited graphics.
I wanted to go even further and built a Python script that — using Pygame’s camera module and curses — captures an image from an attached webcam (USB or built-in), transforms it and displays it on the shell.
Although both the resolution and the color depth are shrunk immensely, the resulting colored text on the shell often resembles the scene caught and has a nice visual effect.
There are two modes, camera and file viewer, which can be toggled by pressing ‘F1’. In camera mode you can see what the camera is seeing and snap a photo, which then will be saved to disk. In file viewer mode you can view the photos you took. The files will be saved in an out/ directory located in the current Python file’s directory. Saved photos have the file extension .si (“shell image”).
Unfortunately, Pygame’s camera module does neither work on Mac OS X nor on Windows. Thus this program is only properly usable under Linux [2] systems. You obviously also need a webcam or else you will not be able to take a picture.


  • ‘F1’ switches between camera and file viewer mode,
  • ‘Space’ saves the current photo as a .si file (only in camera mode),
  • Left or down arrow key decreases current file’s id (only in file viewer mode),
  • Right or up arrow key increases current file’s id (only in file viewer mode).
Source code: curses-cam.py


  1. [2020-07-20] Technically, that is a command prompt used to interact with a terminal.
  2. [2020-07-20] GNU/Linux!