ONEKO(6)

🐱✨ ONEKO — the oneko manual, section 6, Games Manual ✨🐱

okay bestie, so this is oneko, from the Games Manual (section 6 obviously 💅), and it's genuinely one of the most iconic little programs ever. let me tell you everything.

---

🌸 NAME 🌸

oneko — the program that creates a cute little cat who chases around your mouse cursor. that's it. that's the whole vibe. 🐾

---

🎀 SYNOPSIS 🎀

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

like, that's a LOT of options but don't panic, we're getting to every single one 🫶

---

💖 DESCRIPTION 💖

so here's the moment: oneko turns your mouse cursor into an actual mouse 🐭 and then spawns a little cute cat, and that cat starts chasing around your mouse cursor. yes, really. the cat just vibes, pursuing your cursor across the screen.

and the payoff? if the cat catches up to the mouse, it starts sleeping. 😴 literally the cutest thing. no cap.

✨ Options ✨

here's the full menu, every flag, nothing skipped:

• -help — prints the help message on usage. your classic "what does anything do" lifeline 🫶
• -tora — makes the cat into "tora-neko". "tora-neko" means a cat with tiger-like stripes. the manpage author genuinely says "I don't know how to say it in English." and honestly? respect. 🐯
• -dog — runs a dog instead of a cat. yeah. betrayal, but okay. 🐶
• -bsd_daemon — runs a 4.3BSD daemon instead of a cat. iconic choice honestly 👑
• -bsd — same as -bsd_daemon. just shorter, we love convenience 💅
• -sakura — runs Sakura Kinomoto instead of a cat 🌸
• -tomoyo — runs Tomoyo Daidouji instead of a cat 🎀
• -time interval — sets the interval timer, which determines the intervals for cat animation. default value is 125000 and the unit is micro-second. smaller value makes the cat run faster 🏃‍♀️💨
• -speed distance — specifies the distance where the cat jumps at one move, in dot resolution. default is 16 🦘
• -idle speed — specifies the threshold of the speed which the mouse has to be running away at to wake the cat up. like, the mouse literally has to book it 😭
• -name name — specifies the window name of the cat 🏷️
• -towindow — when oneko starts with this option, you must select a window by cursor. then the cat appears and starts chasing the window instead of the mouse. you can select another running oneko as the target window. if the root window is selected, the cat chases the mouse as usual. when the target window is not in sight and not closed, the cat chases the mouse as usual. if the target window is closed, this program exits 🚪
• -toname name — specifies the window name of the target, to make the cat chase it 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 as usual. if the target window is closed, this program exits 🚪
• -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 as usual 🎯
• -position geometry — specifies X and Y offsets in pixels, to adjust the position of the cat relative to the mouse pointer 📍
• -rv — reverses background color and foreground color 🔄
• -noshape — don't use the SHAPE extension 🙅‍♀️
• -fg color — foreground color 🎨
• -bg color — background color 🎨

---

💜 Resources 💜

the application name is "neko" (or "tora") and the class name is "Oneko". periodt.

• tora — set to True if you want "tora-neko" 🐯
• time — sets the interval timer in micro-second ⏱️
• speed — sets the distance to jump in pixel 🦘
• idle — sets the speed threshold to wake the cat up when the mouse is running away 😴
• noshape — set to True if you don't want to use the SHAPE extension 🙅‍♀️
• reverse — set to True if you want to switch foreground and background color 🔄
• foreground — foreground color 🎨
• background — background color 🎨

---

🦋 Notes 🦋

okay important stuff, listen up bestie:

while this program uses XGetDefault, be sure to use the "neko.resouce" form. (yes, that spelling, we're keeping it exactly as it is, no notes 💀)

if you run this program as "tora" — by hard or soft link — the -tora option is enabled by default. sneaky and slay ✨

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 relay team of legends 🫶👑

---

⭐ MAINTAINER ⭐

send questions or problems to mukose@hbar.mp.es.osaka-u.ac.jp 📬

---

and that's the whole thing, bestie! go forth and let the cat catch the mouse 🐱💨🐭 — this has been ONEKO(6) from the Games Manual, section 6, and we're sending you off with all the love 🎀💖✨