dispcat 0.1.1

A CLI tool to display random cat images in separate windows on your screen, with optional frameless mode.

dispcat

dispcat is a simple CLI tool that displays random cat images in separate windows on your screen. You can choose how many cats to display, how many "waves" of cats to see, and optionally hide the OS window toolbar for a frameless experience.

Features

• Display one or more random cat images in separate windows
• Show multiple "waves" of cats, each wave appearing after the previous closes
• Option to hide the OS window toolbar (frameless mode)
• Fast and easy to use from the command line

Installation

You need Python 3.10 or higher.

Install using Poetry:

poetry install

Or install directly with pip:

pip install dispcat

Usage

Run the following command to display a cat:

dispcat

To display multiple cats:

dispcat --count 5

To display cats in frameless windows:

dispcat --frameless

To display several waves of cats (each wave appears after the previous closes):

dispcat --waves 3

You can combine options:

dispcat --count 4 --waves 2 --frameless

Options

Option	Description	Default
--count	Number of cat images to display per wave	5
--waves	Number of waves of cats to display	1
--frameless	Hide OS window toolbar (frameless mode)	False