TikTok Live Reader

• Записване на извлечените данни в текстови файлове. Те по подразбиране се създават в Папка Документи\TikTok live.
• Възможност за архивиране на всички изминали лайф сесии в подпапка Backups. Файловете се подреждат в подпапки по дата, час и домакин.
• Запазва се информация за следните събития: коментари, нови последователи, гифтове, харесвания, споделяния, посетители, заявки за присъединяване към лайфа.
• Създава се файл със събития, в който могат да се записват няколко типа данни наведнъж.
• Предвидена е възможност за възпроизвеждане на звуци за избраните в настройките на добавката събития например при нов коментар, гифт и така нататък.
• Извличат се основни статистики за лайфа в отделен файл. В него се показва текущият брой зрители, посетителите, преминали през лайфа от началото на сесията, общият брой харесвания до момента, колко нови последователи е натрупал домакинът, събрани диаманти от началото на сесията.
• Създава се файл с топ класация на гифтърите. Те се подреждат от най-активния към този с най-малък принос. Определя се по брой изпратени диаманти към домакина.
• Налична е и класация за потребителите, които са харесали лайфа. Подреждат се на същия принцип като при гифтовете.

• comments.txt - В този файл се добавят всички коментари, засечени по време на лайфа. Те са придружени с дата и час.
• followers.txt - Регистрират се потребителите, които са последвали домакина по време на текущата сесия на добавката.
• gifts.txt - Тук се записват всички подаръци, получени от домакина на лайфа. Докладва се кой потребител колко подаръка от даден вид е изпратил, заедно с датата и часа.
• likes.txt - В този файл се показва кой, кога и по колко пъти е харесал лайфа.
• requests.txt - Регистрира всички заявки за присъединяване, отправени към домакина.
• shares.txt - Записва потребителите, които са споделили лайфа заедно с дата и час.
• stats.txt - Показва текущият брой зрители, колко нови последователи е събрал домакинът, всички харесвания на лайфа, колко посетители са минали по време на текущата сесия, общият брой събрани диаманти.
• top gifters.txt - Съдържа класация на потребителите, изпратили подаръци в лайфа, подредени от най-активния към този с най-малко гифтове.
• top likes.txt - Същата логика, само че за харесванията.
• visitors.txt - В този файл се записват всички посетители, минали през лайфа по време на текущата сесия на добавката, заедно с дата и час.
• events.txt - При навигация с клавиатурата този файл е разположен между коментарите и последователите. В него могат да се записват различни типове събития, определени в настройките на добавката. Идеята е лесно да се проследяват няколко типа данни на едно място - коментари, последователи, гифтове, харесвания, заявки за присъединяване, споделяния и посетители.

Настройки

Общи

• Потребителско име - Тук се въвежда потребителското име на домакин на лайф без знак кльомба преди него.
• Местоположение на текстовите файлове - Определя в коя папка да се записват. По подразбиране тя е Документи\TikTok live. С бутона Преглед може да се избере друга папка. Новото местоположение влиза в сила при следващото свързване към лайф.
• Изчистване на файловете при стартиране - Изтрива съдържанието на текстовите файлове при включване на добавката.
• Опростяване на потребителските имена - Тази опция има за цел да изчисти всичко излишно от имената на потребителите, които взаимодействат с лайфа. Нейната необходимост беше породена от това, че голяма част от потребителите в TikTok слагат в своите имена емоджита и всякакви други Unicode символи, които пречат при прочитане на името с екранен четец. Когато опцията е включена, от имената на потребителите се изчиства всичко излишно и в тях остават само букви, цифри и препинателни знаци.
• Архивиране на всяка лайф сесия - Когато опцията е включена, в директорията с текстови файлове се създава папка Backups. При изключване на добавката всяка приключила сесия се копира в собствена подпапка, чието име съдържа дата, час и домакин например 2026-08-15 21-40-03 potrebitel. Така сесиите се подреждат хронологично и най-новите остават отдолу. Подредбата и структурата на текстовите файлове е същата като при тези в основната директория.
• Брой опити за свързване - Определя колко пъти добавката да опитва да се свърже с лайфа на зададения потребител.

Събития

Автоматично изговаряне

Звуци

• Сила на звука - Този плъзгач определя колко да са силни звуковите сигнали за събития.
• Научаване на звуците - Възпроизвежда тяхно описание, за да може потребителят да ги чуе предварително.

Как се използва добавката

• Control+Shift+Стрелка надясно - следващ файл например Коментари, Събития, Последователи, Гифтове и така нататък.
• Control+Shift+Стрелка наляво - Предишен файл.
• Control+Shift+Стрелка надолу - Следващ елемент в текущия файл например коментар, харесване, споделяне.
• Control+Shift+Стрелка нагоре - Предишен елемент в текущия файл.
• Control+Shift+Home - Премества фокуса върху първия елемент от текущия файл например първият нов последовател.
• Control+Shift+End - Придвижване до последния елемент в текущия файл.
• NVDA+Shift+Control+V - Докладва колко зрители има в момента.
• Nvda+Shift+Control+S - Включва и изключва функцията за автоматично изговаряне на избраните в настройките събития.
• NVDA+Shift+Control+P - Включва и изключва звуците.
• NVDA+Shift+Control+R - Премахва съдържанието на текстовите файлове. Преди изтриването се показва въпросително съобщение, което изисква потвърждение с бутона Да. Това е с цел да се предотврати активиране на командата по невнимание.

Някои особености

• При отваряне на настройките на добавката, изговарянето на събития и звуците временно се деактивират, ако са били включени. Записването на данни продължава на заден фон.
• Ако има активна сесия и потребителското име в настройките е променено, след тяхното запазване добавката ще се опита да се свърже с новия потребител.
• Когато автоматичното изчистване на файловете при стартиране е изключено, в тях ще са останали данни от последния лайф. Ако искате да ги изчистите в началото на текущата сесия, натиснете NVDA+Shift+Control+R.
• Също така когато файловете не се изтриват автоматично, при рестарт на добавката тя се опитва да позиционира потребителя там, където последно е бил например върху ред 45 от файла с коментари.

Ограничения

• Исках да добавя функция за показване на всички текущи зрители в лайфа. Но библиотеката TikTokLive не може да докладва напускане на даден потребител.
• Също така исках да има класация на зрителите по време, прекарано в лайфа. Но поради липса на информация за това кога даден потребител е излязъл, не може да се създаде такава функционалност.
• При превода на добавката на български се установи, че подаръците в TikTok са твърде много и социалната мрежа ги променя постоянно. Поддръжката на такъв превод не е рентабилна, затова имената на подаръците ще се съобщават на английски.
• Когато се регистрират заявки за присъединяване, ако потребителят по някакъв начин е взаимодействал с лайфа, неговото име се вижда във файла requests.txt. Но ако не е проявил активност, най-малкото да е бил отразен като посетител, заявката ще бъде игнорирана. Причината за това поведение е, че TikTok не извежда публично имената на потребителите, които искат да се присъединят към лайф и трябва те да се извличат от вече събраните по време на сесията хора.

Списък с промените

Версия 1.8

1. Добавено е въпросително съобщение при изтриване на всички файлове с NVDA+Shift+Control+R. Целта е да се избегне активирането на командата по невнимание.
2. Вече има настройка за избор на местоположение на текстовите файлове. То по подразбиране остава в Документи\TikTok live.
3. Нова опция Архивиране на всяка лайф сесия. В основната директория с текстовите файлове се създава папка Backups. В нея се добавят подпапки с текстовите файлове от всички изминали лайф сесии. Имената им съдържат дата, час и домакин.
4. Настройките на добавката вече ще се запазват в основната папка на NVDA. Така няма да се възстановяват до стойностите по подразбиране при следващи обновявания на TikTok Live Reader.
5. Минималната поддържана версия на NVDA вече е 2025.1.
6. Рефакториране и оптимизиране на част от кода, подобрена е стабилността и са отстранени някои грешки.

Версия 1.6

1. Добавката вече е съвместима с NVDA 2026.1.
2. Настройките в раздел Събития сега отговарят само за файла events.txt. Те определят какви типове данни да се записват в него.
3. Добавен е раздел Звуци с главен превключвател опцията Възпроизвеждане на звуци за избраните събития.
4. По този начин функцията за автоматично изговаряне, възпроизвеждането на звуци и записването на данни във файла със събития не са зависими помежду си.

Версия 1.5

1. Стабилизирана е логиката за зареждане и изключване на добавката.
2. Вече се използва шаблонът NVDA addon template, което ще улесни автоматизацията при създаване на нови версии, преводи на интерфейса и така нататък.
3. Стабилизирана е логиката за записване на харесвания, споделяния и последвания.
4. Стойността на опцията за автоматично изговаряне на събития вече се взема предвид от добавката. Когато автоматичното изговаряне е включено, се изчаква 10 секунди след успешно свързване с потребител и тогава започва съобщаването на събития.
5. Опцията вече е добавена и в съответния раздел с име Автоматично изговаряне на избраните събития. Само когато е включена, тогава се показват останалите отметки - Коментари, Последователи, Гифтове и така нататък.
6. Коригиран бъг, при който в някои случаи се възпроизвеждаха звуци и се изговаряха събития веднага след рестарт на TikTok Live Reader.
7. Добавена е клавишна комбинация NVDA+Shift+Control+P за включване и изключване на звуците. Тя е в сила, когато има активна сесия и се записват събития.
8. Добавени са клавиши за бърз достъп (access keys) за различните настройки, когато прозорецът е отворен. Това са клавишни комбинации с Alt и буквите.
9. Изчистена е логиката за плъзгача Audio volume. Той вече се нарича само Volume на английски, на български етикетът си остава Сила на звука.
10. Преводът на опцията Clean usernames е променен на Опростяване на потребителските имена.
11. Настройките вече се запаметяват динамично. При отваряне на техния прозорец, добавката продължава да записва събития на заден фон, но звуците и автоматичното изговаряне се изключват временно. След затварянето на настройките, тези функции отново работят както се очаква.
12. Ако потребителското име в настройките е променено, след тяхното затваряне добавката прави опит да се свърже с новия потребител.
13. Добавена е възможност за регистриране на заявки за присъединяване към лайфа. Те се записват във файла requests.txt, който се намира при останалите текстови файлове в папка Документи\TikTok live.
14. Вече има опция Заявки в настройките за събития и автоматично изговаряне. Също така е добавен и нов звуков сигнал, който се възпроизвежда ако докладването на това събитие чрез звук е включено.
15. Ако се въведе потребителско име, по-малко от два символа или то съдържа само интервали, добавката изговаря съобщение за грешка. Полето може да приема само букви на латиница, числа и препинателни знаци.

Благодарности

• Благодаря на MuhammadGagah, който много ми помогна с оптимизирането на логиката за включване и изключване на добавката и за нейното зареждане в изолирана среда. Също така той добави индонезийски превод на интерфейса и документацията.
• Благодарности към Бена Къркова за добрите идеи, които ми е давала по време на разработката на този проект и за огромната подкрепа и вяра в него.

Финални уточнения