NEWS

23 april 2024 - Beseda 1.2.1
* EPUB support fixed a lot
* other fixes

ABOUT

This Public Domain console program speaks the ebooks and is controlled via the keyboard to make it handy for the vision accessibility. Fast and simple.

It supports the following formats: TXT, FB2, EPUB, [X]HTML, ODT, DOCX, KWD, ABW.

For the speech it uses Speech Dispatcher service that must be installed and configured separately. Speech Dispatcher needs some voice synths, such as https://github.com/RHVoice, Festival, Flite or espeak-ng. Please read the documentation for your Linux distro or those programs for a details.

INSTALL

To install Beseda, you can try to find the package for your distro (if available), or build it from the source. This link points to the latest release, and here is the project page at Github.

Arch users can install from AUR: yay -S beseda

To build Beseda from the source, you need some utilities and packages. The dependencies are:

g++ and cmake - the standard tools to build programs.
libspeechd - library of Speech Dispatcher, can be named libspeechd-dev in Debian or Ubuntu.
ncurses) for the console interface.

Beseda's source code also bundles pugixml and zip libraries.

To build Beseda, unpack the source tarball, go to the created dir and run the followed commands

mkdir b
cd b
cmake ..
make
sudo make install

USE

To run Beseda is the simpliest case, just type and press enter:
beseda ebook_file_name
If ebook_file_name is not in the current directory, write the full path name. If it has spaces, enclose the path to the "double quotes".

Or, you can run:
beseda directory_name
Beseda runs at the choosed directory, and then you can select some file with left/right cursor keys. Press Enter to load the file.

If no file or directory used as the parameter, Beseda opens at the current working directory.

After loading the file, Beseda speaks paragraph by paragraph (i.e. line by line).

When runned, Beseda allows you to navigate through the files list (supported formats only) at the directory of the current file, or directory from the parameter, or the current working directory. Use left and right cursor keys to navigate, and Enter to load and play.

About other control keys read the next section. Consider the slots/bookmarks conception to open favourites books quickly.

KEYBOARD

q - exit
Up/Down - scroll the current text by the paragraph
PageUp/PageDown - scroll the current text by 7 paragraphs
Left/Right - go to previous/next supported file at the current directory
Enter - load and play the selected (by left/right) file
Space - when playing, play or pause. If the current paragraph is big, the pause may not work immidiately, so don't press Space again, just wait and you will be awarded for your patience with the solid rock pause.
0..9 - choose the current bookmark slot
F2 - save the current file name and posion as the bookmark at the current bookmark slot
F3 - load the file and the position to the current slot, if it has been saved previously. Thus, you can run Beseda without any file at the command line, then select the slot and load file to it with the saved position.
[ or ] select the installed speech synth voice. Bu default, only voices for the current locale is available. To get the full list with all languages, press Z - it is the cycle mode switch, so press it to switch between the modes. Or, add "locale_only=0" line (without double quotes) to $HOME./config/beseda/beseda.conf and reload Beseda. The side effect that there are can be too many voices and you will be tired to list them one by one.

Most voices are binded to one langiage, so to speak for example Afrikaans you need the Afrikaans voice. Also there are exists voices that supports two languages at the same time, they are named for example Alex+Anna.

DONATE

If you like this software, you can donate to me, Peter Semiletov, via Paypal: peter.semiletov@gmail.com

НОВОСТИ

23 апреля 2024 - Beseda 1.2.1
* Существенно исправлена поддержка EPUB
* Прочие исправления

О ПРОГРАММЕ

Беседа это шаровая консольная программа для Linux, которая может читать вслух электронные книжки и управляется при помощи клавиатуры, что делает ее удобной для тех, кто плохо видит.

Поддерживаются такие форматы: TXT, FB2, EPUB, [X]HTML, ODT, DOCX, KWD, ABW.

Для чтения вслух используется сервис Speech Dispatcher, который надо установить и настроить отдельно. А Speech Dispatcher требует модули синтеза речи, например https://github.com/RHVoice, espeak-ng или Festival, Flite. Пожалуйста, читайте в документации к вашему дистрибутиву Linux или этим программам, как их установить и настроить.

УСТАНОВКА

Чтобы установить Беседу, попробуйте найти ее пакет для своего дистрибутива Linux, или же соберите из исходника. Эта ссылочка указывает на последний выпуск, а вот страница проекта на Github. Пользователи Arch могут просто дать команду yay -S beseda

Для сборки из исходников, вам понадобится кое-какой софт:

g++ и cmake - стандартный набор для сборки программ.
libspeechd - библиотека Speech Dispatcher, называется libspeechd-dev в Debian и Ubuntu.
ncurses для консольного интерфейса.

В исходники Беседы включены библиотеки pugixml and zip, из скачивать не нужно.

Для сборки Беседы, распакуйте архив с исходником, зайдите в полученный каталог и дайте следующие команды:

mkdir b
cd b
cmake ..
make
sudo make install

ИСПОЛЬЗОВАНИЕ

В простейшем случае, для запуска Беседы достаточно набрать и потом нажать Enter:
beseda имя_файла_с_книгой
Если beseda имя_файла_с_книгой не находится в текущем каталоге, укажите полный путь. Если в пути есть пробелы, заключите путь в "двойные кавычки".

Либо, вы можете запустить так:
beseda имя_директории
И Беседа загрузится в указанной директории, где вы сможете курсорными клавишами влево-вправо выбрать нужный файл и загрузить его, нажав Enter.

После запуска, Беседа позволяет вам перемещаться по списку файлов поддерживаемого формата вперед-назад (клавишами влево-вправо) в пределах каталога с текущим файлом либо, если никакой файл не открыт, в рабочем каталоге или каталоге, переданном в качестве параметра. Клавиша Enter загружает выбранный файл в Беседу и та начинает его произносить.

Про другие клавиши управления читайте в следующем разделе. Обратите внимание на концепцию слотов/закладок как на удобный способ быстро открывать избранные книги в нужных местах.

КЛАВА

q - выход из программы
Вверх/Вниз - прокручивать текущий текст по параграфу
PageUp/PageDown - прокручивать текущий текст по семь параграфов
Влево/Вправо - переместиться на предыдущий или последующий файл относительно текущего в его каталоге
Enter - загрузить выбранный при помощи влево-вправо файл
Пробел - пауза или снять с паузы. Если параграф большой, установка на паузку может сработать не сразу, так что не пробуйте повторно, просто ждите. Это специфика движка, стало быть не баг, а фича.
0..9 - выбрать текущий слот закладок
F2 - сохранить в текущий слот текущий файл и положение в нем
F3 - загрузить в текущий слот сохраненный в нем ранее файл и перейти к положению в нем

ПОДДЕРЖАТЬ ПРОЕКТ

Буду рад донатам на Paypal по адресу peter.semiletov@gmail.com