Продуктивность

Отчёт по времени

Суммирует сессии трекера времени по проектам и сохраняет отчёт в CSV.

Shell Linux macOS Продвинутый
Скачать time_report.sh
Описание

Что делает скрипт

Скрипт читает JSONL-журнал, фильтрует записи по датам и проекту, затем складывает секунды. Результат выводится таблицей или записывается в новый CSV-файл. Для разбора JSON используется jq.

Запуск

Быстрый старт

bash time_report.sh --from 2026-11-01 --to 2026-11-30

Скачайте файл, откройте терминал в папке со скриптом и выполните команду.

Примеры

Другие варианты

  • bash time_report.sh --from 2026-11-01 --to 2026-11-30
  • bash time_report.sh --project website
  • bash time_report.sh --from 2026-11-01 --csv report.csv
Зависимости

Что понадобится

Bash 4+ Стандартные утилиты coreutils, grep и awk
Linux sudo apt install bash
macOS brew install bash
jq Разбор JSONL с записями трекера времени
Linux sudo apt install jq
macOS brew install jq
Исходник

time_report.sh

#!/usr/bin/env bash
set -euo pipefail

usage() {
    echo "Использование: $0 [--log FILE] [--from YYYY-MM-DD] [--to YYYY-MM-DD] [--project NAME] [--csv FILE] [--force]"
}

log="${HOME}/.productivity/time.jsonl"
from=""
to=""
project=""
csv=""
force=0

while [[ $# -gt 0 ]]; do
    case "$1" in
        --log) log="${2:-}"; shift 2 ;;
        --from) from="${2:-}"; shift 2 ;;
        --to) to="${2:-}"; shift 2 ;;
        --project) project="${2:-}"; shift 2 ;;
        --csv) csv="${2:-}"; shift 2 ;;
        --force) force=1; shift ;;
        -h|--help) usage; exit 0 ;;
        *) echo "Неизвестный аргумент: $1" >&2; usage >&2; exit 2 ;;
    esac
done

if ! command -v jq >/dev/null 2>&1; then
    echo "Нужен jq для разбора журнала" >&2
    exit 2
fi
if [[ ! -f "$log" ]]; then
    echo "Журнал не найден: $log" >&2
    exit 1
fi

rows="$(jq -r --arg from "$from" --arg to "$to" --arg project "$project" '
    select((((.start // "")[0:10]) >= $from or $from == "") and
           (((.start // "")[0:10]) <= $to or $to == "") and
           (.project == $project or $project == "")) |
    [(.project // "?"), (.seconds // 0)] | @tsv
' "$log")"

if [[ -z "$rows" ]]; then
    echo "Записей по фильтру нет."
    exit 0
fi

summary="$(printf '%s\n' "$rows" | awk -F'\t' '
    { sum[$1] += $2 }
    END { for (name in sum) printf "%s\t%d\n", name, sum[name] }
' | sort)"

total="$(printf '%s\n' "$summary" | awk -F'\t' '{ sum += $2 } END { print sum }')"

printf '%-24s %10s %10s\n' "Проект" "Секунды" "Часы"
printf '%s\n' "$summary" | while IFS=$'\t' read -r name seconds; do
    printf '%-24s %10d %10.2f\n' "$name" "$seconds" "$(awk -v s="$seconds" 'BEGIN { printf "%.2f", s / 3600 }')"
done
printf '%-24s %10d %10.2f\n' "Итого" "$total" "$(awk -v s="$total" 'BEGIN { printf "%.2f", s / 3600 }')"

if [[ -n "$csv" ]]; then
    if [[ -e "$csv" && "$force" -eq 0 ]]; then
        echo "Файл уже существует: $csv. Добавьте --force." >&2
        exit 1
    fi
    mkdir -p "$(dirname "$csv")"
    {
        echo "project,seconds,hours"
        printf '%s\n' "$summary" | awk -F'\t' '{ printf "%s,%d,%.2f\n", $1, $2, $2 / 3600 }'
        printf 'total,%d,%.2f\n' "$total" "$(awk -v s="$total" 'BEGIN { printf "%.2f", s / 3600 }')"
    } > "$csv"
    echo "CSV сохранён: $csv"
fi

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get productivity-time-report
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Продуктивность

Заметки, время, задачи, напоминания и автоматизация рутины.