ONEKO(6)

💖 ONEKO(6) — Games Manual 💖

okay bestie, sit down, hydrate, and let me tell you about oneko 🐱 this is a little X11 toy from the Games Manual and it is genuinely one of the most iconic things ever shipped in a games package, no cap.

✨ NAME ✨

oneko — creates a cute cat chasing around your mouse cursor. that's it. that's the whole job. she is a cat. she is coming for your pointer. 🎀

🌸 SYNOPSIS 🌸

oneko [-help] [-tora] [-dog] [-sakura] [-tomoyo] [-time n] [-speed n]
[-idle n] [-name name] [-towindow] [-toname name] [-tofocus] [-position
geometry] [-rv] [-noshape] [-fg] [-bg]

look at all those little switches, she's got RANGE 💅

🦋 DESCRIPTION 🦋

so like, what oneko does is it changes your mouse cursor into a little mouse 🐭 and then spawns an adorable cat who starts chasing around your mouse cursor. and the second the cat catches the ``mouse''? she goes to sleep. periodt. nap time. the hunt is over, the girl is resting. 😴

🌈 Options 🌈

every single one, bestie, no skipping:

• -help — prints a help message on usage. your lil "what do all these do" button. 🫶
• -tora — makes the cat into a "tora-neko", which is a cat with tiger-like stripes. stripes!! 🐯
• -dog — runs a dog instead of a cat. yes it's a cat program and yes there's a dog. we contain multitudes.
• -sakura — runs Sakura Kinomoto instead of a cat. ✨
• -tomoyo — runs Tomoyo Daidouji instead of a cat. 💜
• -time interval — sets the interval timer that determines the intervals for cat animation. default value is 125000 and the unit is micro-second. smaller value makes the cat run faster. she's on a schedule and she's booked and busy.
• -speed distance — specify the distance where the cat jumps at one move, in dot resolution. default is 16. this is how far she YEETS per move.
• -idle speed — specify the threshold of the speed which the ``mouse'' running away has to hit to wake the cat up. mouse got zoomies → cat wakes up.
• -name name — specify the window name of the cat. name your girl!!
• -towindow — when oneko starts with this option, you have to select a window by cursor. then the cat appears and starts chasing the window instead of the mouse. you can even select another running oneko as the target window 👀. if the root window is selected, the cat chases the mouse like usual. when the target window is not in sight and not closed, the cat chases the mouse like usual. and if the target window gets closed, this program exits. so like. don't close her target or she's GONE. 💀
• -toname name — specify the window name of the target, so the cat chases that instead of the mouse. you can specify another running oneko as the target window. when the target window is not in sight and not closed, the cat chases the mouse like usual. if the target window is closed, this program exits. same rules, same drama. 😭
• -tofocus — makes the cat run to and on top of the focus window. when the focus window is not in sight, the cat chases the mouse like usual. she follows the vibes, and the vibes are the focus window.
• -position geometry — specify X and Y offsets in pixels to adjust the position of the cat relative to the mouse pointer. nudge her around, she doesn't mind. 🧚
• -rv — reverse background color and foreground color. flip the whole palette, it's giving remix.
• -noshape — don't use the SHAPE extension. no fancy window shape for you.
• -fg color — foreground color.
• -bg color — background color.
• -cursor cursornumber — specify a cursor number to set when quitting. for example, 132 is the default root cursor. so when the program bails, your pointer goes back to being the classic root cursor. important detail, don't lose it.

🎀 Resources 🎀

application name is "neko" (or "tora") and the class name is "Oneko". very demure, very mindful naming convention.

• tora — set ``True'' if you want a "tora-neko".
• time — sets the interval timer in micro-second.
• speed — sets distance to jump in pixel.
• idle — sets the speed threshold to wake the cat up when the ``mouse'' is running away.
• noshape — set ``True'' if you don't want to use the SHAPE extension.
• reverse — set ``True'' if you want to switch the foreground and background color.
• foreground — foreground color.
• background — background color.

⭐ Notes ⭐

while this program uses XGetDefault, be sure to use "neko.resouce" form. yes, exactly like that. write it how it's written here. 🙈

if you run this program as "tora", by hard or soft link, the -tora option is enabled by default. so a symlink named tora = instant stripes.

BSD Daemon Copyright 1988 by Marshall Kirk McKusick. All Rights Reserved. 📜

Sakura Kinomoto and Tomoyo Daidouji are characters in a comic strip "CARDCAPTOR SAKURA" (CLAMP, Kodansha), with the sanction indicated in CLAMP SCHOOL WEB CAMPUS (http://www.clamp.f-2.co.jp/). 🌸✨

👑 AUTHOR 👑

the original xneko is written by Masayuki Koba, and modified to oneko by Tatsuya Kato, and modified furthermore by John Lerchey, Eric Anderson, Toshihiro Kanda and Kiichiroh Mukose. a whole squad of legends, fr fr. 🔥

💌 MAINTAINER 💌

send questions or problems to mukose@hbar.mp.es.osaka-u.ac.jp. they're the one holding the cat, be nice to them. 🫶

okay that's the whole page bestie, and just so you have the receipts: this is ONEKO(6) from the Games Manual 💖 the maintainer's contact is the one up there, and the copyright/credits lines live in the Notes and Author sections. go forth and let the cat chase the mouse 🐭🐱💅