TJ3SS_SENDER(1)

📦
version 3.8.1 · 5 versions
, in ubuntu resolute, ubuntu stonking

💌 TJ3SS_SENDER — the manual page, but make it a group chat 💌

okay bestie, gather round, because we're talking about tj3ss_sender — yes that's the name of the manual page, and yeah it's a mouthful, she's giving "my parents named me after a variable" energy and we love her for it. This is from the TaskJuggler crew, and it's literally just the thing that mails out status sheet templates to your project managers. Iconic. Necessary. Lowkey the backbone of your whole reporting situation. 💅

✨ NAME ✨

tj3ss_sender — send out status sheets templates via email 🫶

✨ SYNOPSIS ✨

tj3ss_sender [options]

that's it, that's the whole vibe. options go in, status sheets come out. 🎀

✨ DESCRIPTION ✨

okay so here's the tea ☕ — this program sends out status sheet templates via email. It whips up status sheet templates specifically for the managers of the project, so they can go be managers about it. 👑

And where does it get the project data from? Not from vibes, bestie. It reaches out via tj3client to a running TaskJuggler server process. So yeah, the server needs to be up and running or this whole plan is giving nothing. 🦋

✨ OPTIONS ✨

one bullet per option, no skips, no cap, we're doing all of them 💖

  • -c, --config <FILE> — use the YAML configuration file you specify here. Your fave custom config? Slay, point at it.
  • --silent — don't show program and progress information. she's mysterious. she's quiet. she says nothing. 🤫
  • --no-color — don't use ANSI control sequences to color the terminal output. Colors should only be used when spooling to an ANSI terminal, but if that detection fails, this option is your emergency "force colors OFF" button. 🚫🌈
  • --debug — enable Ruby debug mode. for when you need to know everything. 🐛
  • -d, --directory <DIR> — use the specified directory as the working directory. set the stage, diva. 📁
  • --dryrun — don't send out any emails and don't do SCM commits. a lil dress rehearsal, no consequences, perfection. 🙈
  • -r, --resource <ID> — only generate a template for the given resource. one special guy only. ✨
  • -f, --force — send out a new template even if one exists already. we're not asking permission, we're just doing it. 💅
  • --hideresource <EXPR> — filter expression to limit the resource list. hide them, bestie, they don't need to be here. 🙈
  • -i, --interval <DURATION> — the duration of the interval. it's a number directly followed by a unit, so 1w means one week (that's the default btw), 5d means 5 days, and 72h means 72 hours. number. then unit. no space, no drama. ⏳
  • -e, --enddate <DAY> — the end date of the reporting period. either as YYYY-MM-DD or as a day of the week, where 0 is Sunday, 1 is Monday, and so on down the line. the default value is 2026-02-04. 📅
  • -h, --help — show this message. hi, hello, here's the help. 🫶
  • --version — show version info. who is she? what version is she? find out. 👑

✨ ENVIRONMENT ✨

  • HOME — the user's home folder. it's used to search for the configuration file if one isn't specified. so like, if you didn't tell her where the config lives, she's checking home. 🏠

✨ FILES ✨

  • .taskjugglerrc or taskjuggler.rc — tj3d searches for a config file named .taskjugglerrc or taskjuggler.rc in the current path, in the user's home path as specified by the HOME environment variable, or in /etc/.

At a minimum, the file has to configure an authentication key, an e-mail delivery method, and a sender e-mail. like, for example:

_global:
   authKey: ********
   smtpServer: smtp.your_company.com
_statussheets:
   senderEmail: 'TaskJuggler <statussheets@taskjuggler.amd.com>'
ngl bestie, you should use your own auth key here and set the file permissions accordingly. do not be out here posting your key in the group chat. 🔐

and psst — an alternative config file location can be specified with the -c, --config FILE option. 🎀

  • statussheets.log — the statussheets log file, created in the working directory. 🪵
  • StatusSheetTemplates — the base directory of the sheet templates, also created in the working directory. 📂

Copyright © 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020

by Chris Schlaeger <cs@taskjuggler.org>

This program is free software; you can redistribute it and/or modify it under the terms of version 2 of the GNU General Public License as published by the Free Software Foundation.

For more info about TaskJuggler see http://www.taskjuggler.org

✨ SEE ALSO ✨

The full TaskJuggler manual is available online at http://www.taskjuggler.org/tj3/manual/, or via the tj3man command. go read it, it's giving ✨knowledge✨

and that's the whole page bestie, no cap 🫶 TaskJuggler 3.8.1, dated January 2026 — she's a classic, she's been doing this since 2006, and she's still out here sending status sheet templates like the main character she is. 🌸💖🎀 literally iconic, periodt. 👑✨

📦 where this page comes from