pilot-read-ical(1)

💅 pilot-read-ical — like, the whole manual, bestie

okay so first things first: this is a page from the pilot-link: Userland conduits section of the manual. Hi. Welcome. Sit down, we're learning about exporting your Palm's Datebook and ToDo stuff to ical format. It's giving retro-tech nostalgia and honestly? Obsessed. 🎀

---

✨ SYNOPSIS ✨

pilot-read-ical [-p|--port <port>] [--version] [-?|--help] [-q|--quiet]
[--usage] [-d|--datebook] [-t|--pubtext  pubtext] [-f|--file  file]

that's the whole vibe right there. short, sweet, slightly chaotic. slay. ✨

---

🌸 DESCRIPTION 🌸

okay so important — this is not the same as the iCal calendar format. Like, yes, the name is right there, but no. Not the same. Reading comprehension check, bestie, iykyk. 🫶

pilot-read-ical lets you pull the contents of the ToDo and Datebook databases right off your Palm handheld, and then converts all that content into an Ical calendar. literally magic, no cap. 🦋

⚠️ okay so listen — the calendar file named by filename WILL be deleted. like, gone. so please, please, do not use your main calendar for this. use a separate one just for this whole operation, and then include that separate one inside your main calendar. that's the move. 💅

and because pilot-read-ical works by passing a script to ical, the ical application must be in your $PATH. if it's not? it's not gonna work, bestie. that's the whole thing. 😭

---

💖 OPTIONS 💖

🎀 pilot-read-ical options

• -d, --datebook — Datebook only, no ToDos. that's it. just the datebook. it's giving "I only have time for one database" energy. ⭐
• -t, --pubtext pubtext — replaces the text of any item that doesn't start with a bullet with pubtext. so if it's not bulleted, it gets swapped. iconic behavior honestly. 🔥
• -f, --file file — this is the file where the ical-formatted data gets saved. and yes, it WILL be deleted — so don't you dare point this at your primary calendar file. check the DESCRIPTION above for the full tea. 🙈

🌈 Conduit Options

• -p, --port port — use the device file <port> to talk to your Palm handheld. if you don't specify it, pilot-read-ical goes looking for the $PILOTPORT environment variable. and if neither of those is found? it just prints the usage information at you. rude but fair. 💀
• -q, --quiet — suppresses the 'Hit HotSync button' message. for when you want the whole process to be silent and mysterious. main character energy, honestly. 🌸
• -v, --version — shows you the version of pilot-read-ical and then dips out without connecting. no device, no connection, just vibes. ✨

🧚 Help Options

• -h, --help — displays the help synopsis for pilot-read-ical and exits without connecting. 🎀
• --usage — displays a brief usage message and exits without connecting. short and sweet, just like this bullet. 💜

---

🦋 USAGE 🦋

here's the whole flow, bestie: the program connects to a target device, retrieves the ToDo and Datebook databases (that's ToDoDB.pdb and DatebookDB.pdb, respectively, if you were wondering 👑), and then it instructs ical to write a calendar file based on all the info it just retrieved. and that's the tea. 🍓

---

👑 AUTHOR 👑

pilot-read-ical was originally written by Kenneth Albanowski. king behavior. 🌟

and this manual page was converted to XML by Neil Williams <linux@codehelp.co.uk>. shoutout. 🫶

---

💀 REPORTING BUGS 💀

okay so we have an online bug tracker, and using it is the only way to make sure your bugs actually get recorded and that we can track them until they're resolved or closed. reporting bugs via email is easy, sure, but it's genuinely not very useful when it comes to accountability. ngl, the tracker is the way. 💅

so point your browser at http://bugs.pilot-link.org:

http://bugs.pilot-link.org

and report your bugs and issues right there. fr fr. 🙏

---

🌈 COPYRIGHT 🌈

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 2 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. 💜

you should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA. 🎀

---

⭐ SEE ALSO ⭐

• pilot-link(7) — go read it, bestie, it's the whole ecosystem. 💖

---

aaaand that's the page! 🎉 sending you off with a lil sign-off: this is version 0.13.0, Copyright 1996-2007 FSF, and this iconic lil manual page is dated accordingly. mwah. 💋✨ no cap, you're gonna slay this. 🫶