CALYPSO(1)

👑 CALYPSO — the manual page, but make it fashion

okay bestie, sit down, hydrate, and let me tell you about calypso 💖 this is the User Commands manual, section 1, and she is serving.

✨ NAME ✨

calypso — a CalDAV/CardDAV server with git storage. like, your calendars and your contacts, living in a git repo. the way that she stores things is genuinely iconic ngl 🌸

🦋 SYNOPSIS 🦋

calypso [options]

that's it. that's the whole vibe. you run her, you give her options, she does her thing 💅

💜 OPTIONS 💜

she has options and we're gonna go through every single one, no skips, no cuts, no "we don't have time for the boring ones" — we DO have time, this is a sleepover 🎀

• -h, --help — show this help message and exit. your girl is helpful, she will literally tell you how to use her. no cap. ✨
• -v, --version — show version and exit. quick lil "hey, this is who I am" moment, then she's out. 👑
• -d, --daemon — launch as daemon. she goes to the background and does her work quietly like the mysterious main character she is 🦋
• -f, --foreground — launch in foreground. the opposite of --daemon. she stays right there with you, holding your hand, being present 🌸
• -H HOST, --host=HOST — set server hostname. tell her where to live bestie 🏡
• -p PORT, --port=PORT — set server port. tell her which door to hang out at 🚪
• -s, --ssl — use SSL connection. encrypted, protected, secure — she's got her little padlock on 🔒✨
• -S, --no-ssl — do not use SSL connection. the opposite of --ssl. no padlock, just vibes 🌈
• -k KEY, --key=KEY — private key file. her secret lil key file 🔑 (keep it secret, keep it safe, that's the whole point)
• -c CERTIFICATE, --certificate=CERTIFICATE — certificate file. the certificate that goes with the key, they're a matched set, they're soulmates fr fr 💖
• -i IMPORT_DEST, --import=IMPORT_DEST — okay so the original page literally lists this option and then gives you zero description. nothing. blank. a mystery. so I'm not gonna invent one for you bestie, because making stuff up about technical things is not the move 😭 all we know is: -i takes an IMPORT_DEST, and the long form is --import=IMPORT_DEST. that's the tea. that's all the tea ☕🙈
• -g, --debug — enable debug logging. she starts oversharing. in a helpful way. it's giving transparency 🔥
• -P PIDFILE, --pid-file=PIDFILE — set location of file containing calypso process-id. this is where her lil ID number gets written down, so you can always find her 🫶

🌸 AUTHOR 🌸

Written by Keith Packard <keithp@keithp.com> — an absolute legend, put some respect on the name 👑

💅 COPYRIGHT 💅

Copyright © 2011,2019 Keith Packard Copyright © 2008-2011 Guillaume Ayoub Copyright © 2008 Nicolas Kandel Copyright © 2008 Pascal Halter

okay so here's the legal part and I need you to actually read it bestie, because it matters, this isn't just filler 💜

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

⚠️ okay this is the serious bit and I'm saying it with my whole chest: no warranty, like, at all. if something breaks, the license already told you. dramatic? yes. accurate? also yes. 🚨

You should have received a copy of the GNU General Public License along with Calypso. If not, see <http://www.gnu.org/licenses/>.

🎀 that's the whole page bestie 🎀

this was calypso 2.0, dated March 2019, and yes, that's the version and the date from the very bottom of the original page, I just folded them into a cute lil sign-off instead of a boring footer line ✨

now go set up your CalDAV server. slay. 💖🦋👑