chronoskin prints a timetable from a text file.

You keep one plain file of times and what happens at them. It gives you back a week, a month or a single day, as text you can read, print or pipe.

chronoskin [-w | -m | -d date] [-f format] [-o file] timetable.txt
chronoskin -c timetable.txt

Download 2.4.1 Read the options what changed in 2.4.1

Status

releases since 201431
lines of C4,180
size of the binary, KB212
libraries it needs0

Chapters rewritten for 2.4 6 of 8

Chapters

chapter 2

The file

One line, one event. How times, days and repeats are written. Read

chapter 3

Options

All fourteen flags in one table, with defaults. Read

chapter 6

Changelog

Every release since 0.1, newest first. Read

chapter 7

Download

Source, four binaries and their checksums. Get it

News

2017-03-14
2.4.1 is out new
Fixes the week that lost an hour when the clocks went forward. Everyone on 2.4.0 should upgrade.

release | 3 fixes | 212 KB
2017-02-02
The -f option now takes a file
A format can live beside the timetable instead of on the command line. The old form still works.

manual | chapter 4 rewritten
2016-11-20
Binaries are now built for ARM
It runs on the small board in the hallway that drives the printer.

download | 1 new file

This release

chronoskin-2.4.1.tar.gz

Source, 88 KB. Builds with any C compiler and make; no configure step.

All files and checksums

Note. 2.4.0 was withdrawn two days after it came out. If chronoskin -V prints 2.4.0, replace it.

Reading

How options are read

Options come before the name of the timetable file and are read from left to right. When two of them disagree, the later one wins, so a shell alias can set your habits and the command line can still overrule them.

Choosing the span

With no option at all the program prints the current week, Monday first. Three flags choose something else, and only one of them may be given:

-w prints a week, which is the default.
-m prints the whole month, one line a day.
-d 2017-03-14 prints that one day in full.

Dates

A date is always year, month, day with hyphens. Nothing else is accepted, and a date that does not exist ends the run with status 2.

All options

all 14
span
output
checking

Flag	What it does	Default	State	Since
-w	Print one week, Monday first.	on	stable	0.1
-m	Print one month, a line for each day.	off	stable	0.4
-d date	Print a single day in full.	today	stable	0.4
-f format	Lay each line out as the format says. May name a file.	%t %e	new	2.3
-o file	Write to the file instead of standard output.	none	stable	1.0
-c	Check the file and print nothing but its mistakes.	off	stable	1.2
-x width	Wrap lines at the width. Use a pager instead.	80	going	0.2

Showing 7 of 14. -x goes in 3.0.

Releases

Version	Date	What changed	State	Lines
2.4, daylight saving
2.4.1	2017-03-14	A week that crosses a clock change keeps all its hours. Files	current	+38
2.4.0	2017-03-12	Time zones are read from the file. Lost an hour in spring.	withdrawn	+412
2.3, formats
2.3.2	2017-02-02	The -f option takes a file as well as a string.	kept	+96
2.3.1	2016-12-09	An empty line in a format no longer ends it.	kept	+7
2.3.0	2016-11-20	Formats. ARM binaries. The -x option is on its way out.	old	+530

< newer
1
2
3
older >

Unreleased

Nothing has been changed since 2.4.1. When something is, it is listed here before it is released.

Report a mistake

Upgrading

Releases within a series read the same files and take the same options. Between series, read the first entry of the new one before you replace the binary.

To see what you have, run chronoskin -V.

From 1.x to 2.x

Weeks start on Monday unless the file says otherwise. Add week sunday as its first line to keep the old behaviour.

Files

File	For	SHA-256, first 16	KB
chronoskin-2.4.1.tar.gz	source	9c41e07ab35d2f18	88
chronoskin-2.4.1-linux-amd64	Linux, 64 bit	03b7d1c95e6a40f2	212
chronoskin-2.4.1-linux-arm	Linux, ARM	e58a20c6714bd93f	196
chronoskin-2.4.1-openbsd-amd64	OpenBSD	71fd08e2a9c3b654	204
chronoskin-2.4.1-macos	macOS 10.9 on	b26c94f0d17e83a5	231

Checking a file

Every file is listed in SHA256, which is signed. Fetch both, then:

sha256sum -c SHA256
signify -V -p chronoskin.pub -m SHA256

Mirrors. The two mirrors copy this directory once a night. A release less than a day old may not be on them yet.

Building

There is no configure step. Unpack, build, and copy one file to where you keep programs:

tar xzf chronoskin-2.4.1.tar.gz
cd chronoskin-2.4.1
make && make test
cp chronoskin ~/bin/

What it needs

A C compiler from this century and make. The tests also want diff.

It did not build

make: cc: not found

No compiler is installed. Install one, or set CC to the one you have.

One test fails on dates

Your clock is in a zone that changes this week. Run the tests again with TZ=UTC.

Permission denied on copy

Copy the binary to a directory of your own; nothing needs root.

Answers

Draft kept. What you typed is stored in this browser until you send it or throw it away.

Not sent. One field below needs another look. Nothing has left this page.

The report

Where

Version

Give the number that chronoskin -V prints, such as 2.4.1.

Reply to

Used once, to answer you. Never published.

What is wrong

Add this to the public list of open reports