Skip to content
View timersession's full-sized avatar

Block or report timersession

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Content in all repositories owned by your account will be closed.
Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
TimerSession/README.md

TimerSession — Full Documentation / Documentación Completa / Полная документация / Повна Документація

🇬🇧 English: Below you will find the complete guide to TimerSession in English.

🇪🇸 Español: A continuación encontrará la guía completa de TimerSession en español.

🇷🇺 Русский: Ниже вы найдёте полную инструкцию к программе TimerSession на русском языке.

🇺🇦 Українська: Нижче ви знайдете повну інструкцію до програми TimerSession українською мовою.


🇬🇧 ENGLISH

TimerSession — Session Timer

A professional application for tracking work sessions, clients, finances, and appointments. Built on PySide6 with a modern design.

🕐 Timer (Main Window)

The main screen with a digital time display.

Feature Description
Start Begins a new session. A dialog opens to select the client and hourly rate
Pause / Resume Pauses and resumes the current session. The display blinks while paused
Stop Ends the session and saves it to history
Time Display Shows time in HH:MM:SS format with fixed character cells (no digit jumping)
Rate & Currency At start, you can set an hourly rate and currency (UAH, $, €, ₽, or custom)

When closing the app: if a session is active, you will be prompted to save it before exiting.

📋 Records

A history of all completed sessions.

Feature Description
View History Table of all sessions: date, time, client, duration, note
Filter by Period Today / Week / Month / Custom date range
Search by Client Instant search by first name, last name, or middle name
Add Record Manually Add a past session with client, date, time, duration, and note
Delete Record Delete a selected record with confirmation
Inline Editing Double-click a table cell to edit it directly
Period Statistics Visit count, total time, average time, number of unique clients

📊 Analytics (Pro)

Financial analytics for sessions.

Feature Description
Financial Overview Total income for the period, broken down by currency
Filtering By period (day/week/month/custom) and by client
Session Table Date, time, client, duration, rate, currency, income
Sort by Income Click the "Income" column header to sort ascending / descending
Currency Switching Click the income block to cycle through currencies
Add / Delete Record Manual addition and deletion of financial records
Edit Rate Change the rate and duration directly in the table with a double-click
Totals Number of sessions, total time (hours), average income, number of clients

💰 Finance (Pro)

Financial record management focused on editing and correcting data.

Feature Description
Record List All financial entries with date, client, amount, and currency
Edit Rate Change the rate and duration directly in the table
Correct Records Manually adjust any financial entry
Summary Total income per currency for the selected period

👥 Clients (Pro)

Client database management.

Feature Description
Client List All clients with full name, last visit date, session count, total time
Add Client Full name (last, first, middle), contact details, notes
Edit Client Modify existing client data
Delete Client Remove a client from the database
Search Fast search by any part of the name
Autocomplete When entering a name anywhere in the app, matching clients from the database are suggested

📅 Appointments (Pro)

Manage client appointments.

Feature Description
Appointment List Table of upcoming and past appointments: date, time, client, note
Add Appointment Select client, date, time, and note. Conflict detection is included
Edit Appointment Modify an existing appointment
Delete Appointment Remove an appointment with confirmation
Google Calendar Two-way sync: appointments are automatically created/updated/deleted in Google Calendar
Date Filter View the schedule for a specific period

⚙️ Settings

Tab Description
Reminders 3 configurable reminders by session time: on/off, after how many minutes, message text, sound
Resolution Window scale (80%–200%)
Currencies Choose which currencies to display and add a custom one
Language Interface language (RU/EN/ES/UK). Change takes effect after restart
Google Calendar Connect a Google account, manage multiple accounts
Telegram Connect a bot — manage schedule and view analytics directly from Telegram
License Activate a license key TSS-XXXX-XXXX-DDMMYYYY

🤖 Telegram Bot

Control the app through Telegram without opening it.

Command Description
Today / /today Today's schedule
Tomorrow / /tomorrow Tomorrow's schedule
Clients / /clients Client list
Status / /status Current active session
Analytics / /analytics Stats and income
Add Appointment / /add Step-by-step appointment creation
Add Session Manually / /addsession Add a past session to analytics
/sessions [N] Last N sessions
/del Name DD.MM.YYYY HH:MM Delete an appointment

🔒 License System

  • The app runs in free mode (timer only) without a key
  • Analytics, Finance, Clients, Appointments sections require an active license
  • With an expired license, sections open with a watermark overlay
  • Key format: TSS-XXXXXXXX-XXXXXXXX-DDMMYYYY

💾 Data Storage

All data is stored locally in %APPDATA%\TimerSession\:

  • sessions.json — session history
  • appointments.json — appointment schedule
  • clients.json — client database
  • ui_settings.json — interface settings
  • license.json — license data



🇪🇸 ESPAÑOL

TimerSession — Temporizador de Sesiones

Una aplicación profesional para registrar sesiones de trabajo, clientes, finanzas y citas. Desarrollada con PySide6 y diseño moderno.

🕐 Temporizador (Ventana Principal)

La pantalla principal con pantalla de tiempo digital.

Función Descripción
Iniciar Inicia una nueva sesión. Se abre un diálogo para seleccionar cliente y tarifa
Pausar / Reanudar Pausa y reanuda la sesión actual. La pantalla parpadea durante la pausa
Detener Finaliza la sesión y la guarda en el historial
Pantalla de Tiempo Muestra el tiempo en formato HH:MM:SS con celdas de ancho fijo (sin saltos de dígitos)
Tarifa y Moneda Al iniciar, se puede establecer una tarifa por hora y moneda (UAH, $, €, ₽ o personalizada)

Al cerrar: si hay una sesión activa, la app preguntará si desea guardarla antes de salir.

📋 Registros

Historial de todas las sesiones completadas.

Función Descripción
Ver Historial Tabla con todas las sesiones: fecha, hora, cliente, duración, nota
Filtrar por Período Hoy / Semana / Mes / Rango de fechas personalizado
Buscar por Cliente Búsqueda instantánea por nombre, apellido o segundo nombre
Agregar Registro Manualmente Añadir una sesión pasada con cliente, fecha, hora, duración y nota
Eliminar Registro Eliminar el registro seleccionado con confirmación
Edición en Línea Doble clic en una celda de la tabla para editarla directamente
Estadísticas del Período Cantidad de visitas, tiempo total, tiempo promedio, clientes únicos

📊 Analítica (Pro)

Análisis financiero de sesiones.

Función Descripción
Resumen Financiero Ingresos totales del período, desglosados por moneda
Filtrado Por período (día/semana/mes/personalizado) y por cliente
Tabla de Sesiones Fecha, hora, cliente, duración, tarifa, moneda, ingreso
Ordenar por Ingreso Clic en el encabezado "Ingreso" para ordenar ascendente / descendente
Cambio de Moneda Clic en el bloque de ingresos para cambiar la moneda mostrada
Agregar / Eliminar Registro Adición y eliminación manual de registros financieros
Editar Tarifa Cambiar la tarifa y duración directamente en la tabla con doble clic
Totales Número de sesiones, tiempo total (horas), ingreso promedio, número de clientes

💰 Finanzas (Pro)

Gestión de registros financieros con enfoque en edición y corrección de datos.

Función Descripción
Lista de Registros Todas las operaciones financieras con fecha, cliente, monto y moneda
Editar Tarifa Modificar la tarifa y duración directamente en la tabla
Corregir Registros Ajuste manual de cualquier registro financiero
Resumen Ingreso total por moneda para el período seleccionado

👥 Clientes (Pro)

Gestión de la base de datos de clientes.

Función Descripción
Lista de Clientes Todos los clientes con nombre completo, fecha de última visita, sesiones, tiempo total
Agregar Cliente Nombre completo (apellido, nombre, segundo nombre), contacto, notas
Editar Cliente Modificar datos de un cliente existente
Eliminar Cliente Quitar un cliente de la base de datos
Búsqueda Búsqueda rápida por cualquier parte del nombre
Autocompletado Al ingresar un nombre en cualquier campo, se sugieren clientes de la base

📅 Citas (Pro)

Gestión de citas con clientes.

Función Descripción
Lista de Citas Tabla de citas próximas y pasadas: fecha, hora, cliente, nota
Agregar Cita Seleccionar cliente, fecha, hora y nota. Incluye detección de conflictos
Editar Cita Modificar una cita existente
Eliminar Cita Eliminar una cita con confirmación
Google Calendar Sincronización bidireccional: las citas se crean/actualizan/eliminan en Google Calendar automáticamente
Filtro de Fecha Ver el horario de un período específico

⚙️ Configuración

Pestaña Descripción
Recordatorios 3 recordatorios configurables por tiempo de sesión: activar, tiempo en minutos, texto, sonido
Resolución Escala de la ventana (80%–200%)
Monedas Seleccionar monedas a mostrar y agregar una personalizada
Idioma Idioma de la interfaz (RU/EN/ES/UK). El cambio se aplica tras el reinicio
Google Calendar Conectar una cuenta de Google, gestionar múltiples cuentas
Telegram Conectar un bot — gestionar horario y ver analíticas directamente desde Telegram
Licencia Activar clave de licencia TSS-XXXX-XXXX-DDMMYYYY

🤖 Bot de Telegram

Controla la aplicación desde Telegram sin abrirla.

Comando Descripción
Hoy / /today Horario de hoy
Mañana / /tomorrow Horario de mañana
Clientes / /clients Lista de clientes
Estado / /status Sesión activa actual
Analítica / /analytics Estadísticas e ingresos
Agregar cita / /add Crear una cita paso a paso
Agregar sesión manual / /addsession Añadir sesión pasada a analíticas
/sessions [N] Últimas N sesiones
/del Nombre DD.MM.AAAA HH:MM Eliminar una cita

🔒 Sistema de Licencia

  • La aplicación funciona en modo gratuito (solo temporizador) sin clave
  • Los módulos Analítica, Finanzas, Clientes, Citas requieren licencia activa
  • Con licencia vencida, los módulos se abren con una marca de agua
  • Formato de clave: TSS-XXXXXXXX-XXXXXXXX-DDMMYYYY

💾 Almacenamiento de Datos

Todos los datos se guardan localmente en %APPDATA%\TimerSession\:

  • sessions.json — historial de sesiones
  • appointments.json — calendario de citas
  • clients.json — base de datos de clientes
  • ui_settings.json — configuración de la interfaz
  • license.json — datos de licencia



🇷🇺 РУССКИЙ

TimerSession — Таймер сеансов

Профессиональная программа для учёта рабочих сеансов, клиентов, финансов и расписания. Разработана на PySide6 с современным дизайном.

🕐 Таймер (главное окно)

Основной экран программы с цифровым дисплеем времени.

Функция Описание
Начать Запускает новый сеанс. Открывается диалог выбора клиента и ставки
Пауза / Продолжить Приостанавливает и возобновляет текущий сеанс. Дисплей мигает при паузе
Стоп Завершает сеанс и сохраняет его в историю
Дисплей времени Показывает время в формате ЧЧ:ММ:СС с фиксированными ячейками (цифры не «прыгают»)
Ставка и валюта При старте можно указать почасовую ставку и валюту (грн, $, €, ₽ или кастомная)

При закрытии: если сеанс активен, программа предложит сохранить его перед выходом.

📋 Записи

Раздел истории всех завершённых сеансов.

Функция Описание
Просмотр истории Таблица со всеми сеансами: дата, время, клиент, длительность, заметка
Фильтрация по периоду Сегодня / Неделя / Месяц / Произвольный диапазон дат
Поиск по клиенту Мгновенный поиск по имени, фамилии, отчеству
Добавить запись вручную Добавление прошедшего сеанса с указанием клиента, даты, времени, длительности и заметки
Удалить запись Удаление выбранной записи с подтверждением
Редактирование Двойной клик на ячейке таблицы — редактирование данных прямо в таблице
Статистика периода Количество визитов, суммарное время, среднее время, число уникальных клиентов

📊 Аналитика (Pro)

Финансовая аналитика по сеансам.

Функция Описание
Финансовый обзор Общий доход за период с разбивкой по валютам
Фильтрация По периоду (день/неделя/месяц/произвольно) и по клиенту
Таблица сеансов Дата, время, клиент, длительность, ставка, валюта, доход
Сортировка по доходу Клик на заголовок «Доход» — сортировка по возрастанию / убыванию
Переключение валют Клик на блок дохода переключает отображаемую валюту
Добавить / удалить запись Ручное добавление и удаление финансовых записей
Редактирование ставки Изменение ставки и длительности прямо в таблице двойным кликом
Итоги Число сеансов, общее время (часы), средний доход, число клиентов

💰 Финансы (Pro)

Управление финансовыми записями с акцентом на редактирование и корректировку данных.

Функция Описание
Список записей Все финансовые операции с датой, клиентом, суммой и валютой
Редактирование ставки Изменение ставки и длительности прямо в таблице
Исправление записей Ручная корректировка любой финансовой записи
Итоговая сводка Суммарный доход по каждой валюте за выбранный период

👥 Клиенты (Pro)

База данных клиентов.

Функция Описание
Список клиентов Все клиенты с ФИО, датой последнего визита, количеством сеансов, суммарным временем
Добавить клиента ФИО (фамилия, имя, отчество), контактные данные, заметки
Редактировать клиента Изменение данных существующего клиента
Удалить клиента Удаление клиента из базы
Поиск Быстрый поиск по любой части имени
Автодополнение При вводе имени в любом поле программы предлагаются варианты из базы клиентов

📅 Расписание (Pro)

Управление записями на приём.

Функция Описание
Список записей Таблица предстоящих и прошедших записей: дата, время, клиент, заметка
Добавить запись Выбор клиента, даты, времени, заметки. Проверка конфликтов расписания
Редактировать запись Изменение существующей записи на приём
Удалить запись Удаление записи с подтверждением
Google Calendar Двусторонняя синхронизация: записи автоматически создаются/обновляются/удаляются в Google Calendar
Фильтр по дате Просмотр расписания на конкретный период

⚙️ Настройки

Вкладка Описание
Напоминания 3 настраиваемых напоминания по времени сеанса: включение, через сколько минут, текст, звук
Разрешение Масштаб окна программы (80%–200%)
Валюты Выбор отображаемых валют и добавление собственной
Язык Язык интерфейса (RU/EN/ES/UK). Изменение применяется после перезапуска
Google Calendar Подключение аккаунта Google, управление несколькими аккаунтами
Telegram Подключение бота — управление расписанием и просмотр аналитики прямо из Telegram
Лицензия Активация лицензионного ключа TSS-XXXX-XXXX-DDMMYYYY

🤖 Telegram-бот

Управление программой через Telegram без открытия приложения.

Команда Описание
Сегодня / /today Расписание на сегодня
Завтра / /tomorrow Расписание на завтра
Клиенты / /clients Список клиентов
Статус / /status Текущий активный сеанс
Аналитика / /analytics Статистика и доходы
Добавить запись / /add Пошаговое добавление записи в расписание
Добавить сеанс вручную / /addsession Внести прошедший сеанс в аналитику
/sessions [N] Последние N сеансов
/del Имя ДД.ММ.ГГГГ ЧЧ:ММ Удалить запись из расписания

🔒 Лицензионная система

  • Программа работает в бесплатном режиме (таймер) без ключа
  • Разделы Аналитика, Финансы, Клиенты, Расписание требуют активной лицензии
  • При истёкшей лицензии разделы открываются с водяным знаком
  • Формат ключа: TSS-XXXXXXXX-XXXXXXXX-DDMMYYYY

💾 Хранение данных

Все данные сохраняются локально в папке %APPDATA%\TimerSession\:

  • sessions.json — история сеансов
  • appointments.json — записи расписания
  • clients.json — база клиентов
  • ui_settings.json — настройки интерфейса
  • license.json — данные лицензии



🇺🇦 УКРАЇНСЬКА

TimerSession — Таймер сеансів

Професійна програма для обліку робочих сеансів, клієнтів, фінансів та розкладу. Розроблена на PySide6 із сучасним дизайном.

🕐 Таймер (Головне вікно)

Головний екран програми з цифровим дисплеєм часу.

Функція Опис
Почати Запускає новий сеанс. Відкривається діалог вибору клієнта і ставки
Пауза / Продовжити Призупиняє та відновлює поточний сеанс. Дисплей блимає під час паузи
Стоп Завершує сеанс і зберігає його в історію
Дисплей часу Показує час у форматі ГГ:ХВ:СС із фіксованими клітинками (цифри не «стрибають»)
Ставка і валюта На старті можна вказати погодинну ставку і валюту (грн, $, €, ₽ або власна)

При закритті: якщо сеанс активний, програма запропонує зберегти його перед виходом.

📋 Записи

Розділ історії всіх завершених сеансів.

Функція Опис
Перегляд історії Таблиця всіх сеансів: дата, час, клієнт, тривалість, нотатка
Фільтрація за періодом Сьогодні / Тиждень / Місяць / Довільний діапазон дат
Пошук за клієнтом Миттєвий пошук за іменем, прізвищем, по батькові
Додати запис вручну Додавання минулого сеансу із зазначенням клієнта, дати, часу, тривалості та нотатки
Видалити запис Видалення вибраного запису з підтвердженням
Редагування Подвійний клік на клітинці таблиці — редагування даних безпосередньо в таблиці
Статистика за період Кількість візитів, сумарний час, середній час, кількість унікальних клієнтів

📊 Аналітика (Pro)

Фінансова аналітика по сеансах.

Функція Опис
Фінансовий огляд Загальний дохід за період із розбивкою по валютах
Фільтрація За періодом (день/тиждень/місяць/довільно) і за клієнтом
Таблиця сеансів Дата, час, клієнт, тривалість, ставка, валюта, дохід
Сортування за доходом Клік на заголовок «Дохід» — сортування за зростанням / спаданням
Перемикання валют Клік на блок доходу перемикає відображувану валюту
Додати / видалити запис Ручне додавання та видалення фінансових записів
Редагування ставки Зміна ставки та тривалості безпосередньо в таблиці подвійним кліком
Підсумки Кількість сеансів, загальний час (години), середній дохід, кількість клієнтів

💰 Фінанси (Pro)

Управління фінансовими записами з акцентом на редагування та коригування даних.

Функція Опис
Список записів Усі фінансові операції з датою, клієнтом, сумою та валютою
Редагування ставки Зміна ставки та тривалості безпосередньо в таблиці
Виправлення записів Ручне коригування будь-якого фінансового запису
Зведений підсумок Загальний дохід по кожній валюті за вибраний період

👥 Клієнти (Pro)

База даних клієнтів.

Функція Опис
Список клієнтів Усі клієнти з ПІБ, датою останнього візиту, кількістю сеансів, сумарним часом
Додати клієнта ПІБ (прізвище, ім'я, по батькові), контактні дані, нотатки
Редагувати клієнта Зміна даних існуючого клієнта
Видалити клієнта Видалення клієнта з бази
Пошук Швидкий пошук за будь-якою частиною імені
Автодоповнення При введенні імені в будь-якому полі програми пропонуються варіанти з бази клієнтів

📅 Розклад (Pro)

Управління записами на прийом.

Функція Опис
Список записів Таблиця майбутніх і минулих записів: дата, час, клієнт, нотатка
Додати запис Вибір клієнта, дати, часу, нотатки. Перевірка конфліктів розкладу
Редагувати запис Зміна існуючого запису на прийом
Видалити запис Видалення запису з підтвердженням
Google Calendar Двостороння синхронізація: записи автоматично створюються/оновлюються/видаляються в Google Calendar
Фільтр за датою Перегляд розкладу за конкретний період

⚙️ Налаштування

Вкладка Опис
Нагадування 3 налаштовувані нагадування за часом сеансу: увімкнення, через скільки хвилин, текст, звук
Роздільна здатність Масштаб вікна програми (80%–200%)
Валюти Вибір валют, що відображаються, та додавання власної
Мова Мова інтерфейсу (RU/EN/ES/UK). Зміна застосовується після перезапуску
Google Calendar Підключення акаунту Google, управління кількома акаунтами
Telegram Підключення бота — управління розкладом та перегляд аналітики прямо з Telegram
Ліцензія Активація ліцензійного ключа TSS-XXXX-XXXX-DDMMYYYY

🤖 Telegram-бот

Управління програмою через Telegram без відкриття застосунку.

Команда Опис
Сьогодні / /today Розклад на сьогодні
Завтра / /tomorrow Розклад на завтра
Клієнти / /clients Список клієнтів
Статус / /status Поточний активний сеанс
Аналітика / /analytics Статистика та доходи
Додати запис / /add Покроковий запис до розкладу
Додати сеанс вручну / /addsession Внести минулий сеанс в аналітику
/sessions [N] Останні N сеансів
/del Ім'я ДД.ММ.РРРР ГГ:ХВ Видалити запис із розкладу

🔒 Ліцензійна система

  • Програма працює у безкоштовному режимі (таймер) без ключа
  • Розділи Аналітика, Фінанси, Клієнти, Розклад потребують активної ліцензії
  • При простроченій ліцензії розділи відкриваються з водяним знаком
  • Формат ключа: TSS-XXXXXXXX-XXXXXXXX-DDMMYYYY

💾 Зберігання даних

Усі дані зберігаються локально в папці %APPDATA%\TimerSession\:

  • sessions.json — історія сеансів
  • appointments.json — записи розкладу
  • clients.json — база клієнтів
  • ui_settings.json — налаштування інтерфейсу
  • license.json — дані ліцензії

For any questions, please contact us at flexovibegroup@gmail.com

Popular repositories Loading

  1. timersession.github.io timersession.github.io Public

    Windows session timer for therapists, coaches and tutors: track sessions, clients and income, export to Excel

    HTML

  2. TimerSession TimerSession Public