MACOPIX(6)

💖 NAME 💖

okay bestie, gather round, because this one is macopix — and in the MACOPIX(6) world (yes that's the man page section, section 6, the games/fun one, iconic) it stands for MaCoPiX - Mascot Constructive Pilot for X. 🎀

---

✨ SYNOPSIS ✨

like, the literal shape of the thing:

macopix [ options ...  ] [ mascot-file ]
macopix [ options ...  ] --menu menu-file

---

🦋 DESCRIPTION 🦋

MaCoPiX is a desktop mascot program running under UNIX / X window systems. lowkey it could be described as an evolved one from ActX (that's "Activate X window system", for the uninitiated 🫶).

So rn, the types of mascots you can make with MaCoPiX are:

• Focus follower (Window sitters : likely ActX) 👀
• Fixed style (Desktop wappen?) 🏠

And on top of that? You can pick with or without a digital clock for each of those mascot types. So MaCoPiX can absolutely be used as a sort of desktop clock application. (But — being so real with you — the clock function is still poor. 💀 it's giving beta energy, and that's okay.)

The biff function is also available for POP/APOP/UNIX local spool environments, which is a whole thing, we'll get to it. And literally all the configuration of MaCoPiX — even including the creation and edit of mascots — is available via GUI menu. No terminal gymnastics required, we love that for you. 🧚

But please pay attention bestie: mascot files of MaCoPiX have no compatibility with those of ActX. Don't try it. They will not slay together. 🙈

---

🌈 ENVIRONMENT 🌈

MaCoPiX is running on the X Window System (and it should be running on a compositing window manager, no cap) of any UNIX operating systems. But, you need:

• Gtk+3 > ver3.22 (or Gtk+2 > ver2.24)
• gettext > ver0.10

...to run this program. ⭐

The good news? MaCoPiX can be used on any Window Managers without any problems. Universal queen behavior. 👑

---

💅 BASIC OPERATION 💅

• The right click for popup menu. In this popup menu, you can change the current mascot and all configuration of MaCoPiX. Furthermore, you can create a new mascot from this menu. And if you want to save your changes, you should execute the "Save" command in this popup menu. (Not me forgetting to save... couldn't be me. 😭)
• The left drag for mascot's horizontal position change on the title bar, if the mascot is in the window-sitter mode. In the case of fix position mascots, the left drag should be the change of fixed position of the mascot. 🫶
• "Click Animation", "Sound Playback" & "Balloon Talk" can be shown with the left click on the mascot. It's giving main character energy fr fr. ✨
• If you started it with the biff-mode, the biff bitmap appears in the case that you have new (or unread) mails. The left click on this biff bitmap enables you to check From: & Subject: of unread mails. 📬
• If your mouse cursor entered the panel of digital clock (if you are using it), the date description tip appears on it. 🕐

---

🔥 OPTIONS 🔥

Usually, you can set a mascot file (.mcpx) to be loaded at the start time in your command line option. If no mascot files are appointed, one of the mascots in the default menu file are selected randomly. (RNG mascot. We respect it. 🎲)

All command line options...

• -h, --help — Print help message.
• -c, --common-dir — Print COMMON Directory.
• -b, --biff — Turn on the biff function.
• -s, --signal — Turn on the time signal function.
• -o, --offset [ offset[%] ] — Set offset-value for Focus Following.
• -r, --rcfile [ rc-file ] — Set the resource file.
• -m, --menu [ menu-file ] — Appoint a menu file to be loaded.
• -mg, --magnify [ magnification rate (%) ] — Set magnification percentage of mascot.
• -i, --ip-style [ (0|1|2|3) ] — Set interpolation style for magnification.
• -a, --auto-install — Set mascot auto install ON.
• -na, --no-auto-install — Set mascot auto install OFF.
• -O, --over-write — Permit to overwrite files in user dir.
• --install-user-mascot [ mascot-file (.mcpx) ] — Install a mascot to your User Directory.
• --install-common-mascot [ mascot-file (.mcpx) ] — Install a mascot to Common Directory.
• --install-user-menu [ menu-file (.menu) ] — Install a menu and mascots in it to your User Directory.
• --install-common-menu [ mascot-file (.menu) ] — Install a menu and mascots in it to Common Directory.
• --sockmsg — Start as a socket message reciever.
• --message [ message ] — Send a message to the socket message reciever.
• --message-expire [ expire-time[msec] ] — The expire time for the socket message (use w/"-message" option).
• -nc, --no-duet-click — Forbid to use the duet animation for click action. Send a message to the socket message reciever.
• -nr, --no-duet-random — Forbid to use the duet animation for random action.

---

💌 Configuration for Biff 💌

MaCoPiX has the biff function for UNIX mbox and qmil Maildir type local spool and POP3 (w/ or w/o APOP) access to the mail server. Froms and Subjects list of arrived mails can be available by click of small biff image with mascot. MIME-encoded mail subjects are automatically decoded by internal functions. (Decoding your emails so you don't have to squint at =?UTF-8?B?...?=, we love a helpful icon. 🎀)

In the Configulation Dialog, these:

• type of biff mode
• the spool file to be checked (for local spool only)
• update interval
• mail server & user name & password for POP3(APOP)
• command for the mailer

...should be set. That's the checklist, bestie. Go forth. ✅

---

🌸 FILES 🌸

HOME$/.macopix/          user directory
HOME$/.macopix/*.mcpx    mascot files
HOME$/.macopix/pixmap/*  mascot image files
HOME$/.macopix/sound/*   mascot sound files

---

👑 AUTHOR 👑

Kurumi Chimari — <chimari@rosegray.sakura.ne.jp>

• URL: http://rosegray.sakura.ne.jp/

---

and that's the whole page, bestie!! this one's from version 3.4.0, dated Dec 28, 2019 — an elder icon that still ate, and it lives in section 6 of the manual, MACOPIX(6). mwah, go install a mascot, you deserve a little guy on your desktop 🫶✨💖