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