Downloads:

158

Downloads of v 1.78:

31

Last Update:

26 May 2021

Package Maintainer(s):

Software Author(s):

  • Ilya Morozov

Tags:

balabolka balcon TTS Text-to-Speech

Balabolka Console (balcon)

  • 1
  • 2
  • 3

1.78 | Updated: 26 May 2021

Downloads:

158

Downloads of v 1.78:

31

Maintainer(s):

Software Author(s):

  • Ilya Morozov

  • 1
  • 2
  • 3
Balabolka Console (balcon) 1.78

  • 1
  • 2
  • 3

Some Checks Have Failed or Are Not Yet Complete

Not All Tests Have Passed


Validation Testing Passed


Verification Testing Passed

Details

Scan Testing Resulted in Flagged as a Note:

At least one file within this package has greater than 0 detections, but less than 5

Details

To install Balabolka Console (balcon), run the following command from the command line or from PowerShell:

>

To upgrade Balabolka Console (balcon), run the following command from the command line or from PowerShell:

>

To uninstall Balabolka Console (balcon), run the following command from the command line or from PowerShell:

>

NOTE: This applies to both open source and commercial editions of Chocolatey.

1. Ensure you are set for organizational deployment

Please see the organizational deployment guide

  • Open Source or Commercial:
    • Proxy Repository - Create a proxy nuget repository on Nexus, Artifactory Pro, or a proxy Chocolatey repository on ProGet. Point your upstream to https://community.chocolatey.org/api/v2. Packages cache on first access automatically. Make sure your choco clients are using your proxy repository as a source and NOT the default community repository. See source command for more information.
    • You can also just download the package and push it to a repository Download

3. Enter your internal repository url

(this should look similar to https://community.chocolatey.org/api/v2)

4. Choose your deployment method:


choco upgrade balcon -y --source="'STEP 3 URL'" [other options]

See options you can pass to upgrade.

See best practices for scripting.

Add this to a PowerShell script or use a Batch script with tools and in places where you are calling directly to Chocolatey. If you are integrating, keep in mind enhanced exit codes.

If you do use a PowerShell script, use the following to ensure bad exit codes are shown as failures:


choco upgrade balcon -y --source="'STEP 3 URL'"
$exitCode = $LASTEXITCODE

Write-Verbose "Exit code was $exitCode"
$validExitCodes = @(0, 1605, 1614, 1641, 3010)
if ($validExitCodes -contains $exitCode) {
  Exit 0
}

Exit $exitCode

- name: Ensure balcon installed
  win_chocolatey:
    name: balcon
    state: present
    version: 1.78
    source: STEP 3 URL

See docs at https://docs.ansible.com/ansible/latest/modules/win_chocolatey_module.html.


chocolatey_package 'balcon' do
  action    :install
  version  '1.78'
  source   'STEP 3 URL'
end

See docs at https://docs.chef.io/resource_chocolatey_package.html.


Chocolatey::Ensure-Package
(
    Name: balcon,
    Version: 1.78,
    Source: STEP 3 URL
);

Requires Otter Chocolatey Extension. See docs at https://inedo.com/den/otter/chocolatey.


cChocoPackageInstaller balcon
{
   Name     = 'balcon'
   Ensure   = 'Present'
   Version  = '1.78'
   Source   = 'STEP 3 URL'
}

Requires cChoco DSC Resource. See docs at https://github.com/chocolatey/cChoco.


package { 'balcon':
  provider => 'chocolatey',
  ensure   => '1.78',
  source   => 'STEP 3 URL',
}

Requires Puppet Chocolatey Provider module. See docs at https://forge.puppet.com/puppetlabs/chocolatey.


salt '*' chocolatey.install balcon version="1.78" source="STEP 3 URL"

See docs at https://docs.saltstack.com/en/latest/ref/modules/all/salt.modules.chocolatey.html.

5. If applicable - Chocolatey configuration/installation

See infrastructure management matrix for Chocolatey configuration elements and examples.

This package was approved by moderator flcdrg on 22 Jun 2021.

Description

Balabolka (Command Line Utility)

The utility differs from the desktop application in that it contains no graphical user interface and works only from the command line. This is useful to integrate the Text-To-Speech process to other applications, for example.

Benefits of the command line utility:

No installation required.
Compact.
Flexible and easy to use.
Low system requirements.
Microsoft Speech API 4 and 5 support.

Please Note: This is an automatically updated package. If you find it is
out of date by more than a day or two, please contact the maintainer(s) and
let them know the package is no longer updating correctly.


legal\LICENSE.txt
From: http://www.cross-plus-a.com/bconsole.htm (bottom of page)

----------------------------

*** Licence ***

You are free to use and distribute software for noncommercial purposes. For commercial use or distribution, you need to get permission from the copyright holder. The application can not be used on the territory of Belarus, Cuba, Iran, North Korea, Syria, and the Crimea Region.
legal\VERIFICATION.txt
VERIFICATION
Verification is intended to assist the Chocolatey moderators and community
in verifying that this package's contents are trustworthy.

Download URL from authors site at: http://www.cross-plus-a.com/bconsole.htm

1. Download http://www.cross-plus-a.com/balcon.zip

2. Extract zip

3. Get sha256 checksums of balcon.exe and libsamplerate.dll with utility of choice, they are also included below for convenience

    ChecksumExe: 48266A6D2A2077064FFCDE0BFC49DF01447520C6FBD32EC15BEC4705AED65BCF
    ChecksumDll: 01BB04EC2D815CE30A5B4D9EDCADA479461D3DE31C78532468C398BC4C328505

4. Check that they match checksums of files included in package
tools\balcon.exe
md5: 116B4EBFA63471DB0C0946D535A77DFD | sha1: 375860C73346E272CB0C7489016C1AED0A4C34D9 | sha256: 48266A6D2A2077064FFCDE0BFC49DF01447520C6FBD32EC15BEC4705AED65BCF | sha512: 4BB1ED55A18A6D1AD371313F2436F5A087A5778451E169D88D9A227AF056F1310D205AEE2DFA77CE6ED90CB6EA33D1189813846A1170D3078EBB41E74DF59762
tools\history.txt
Balabolka (Command Line Utility)
Copyright (c) 2013-2021 Ilya Morozov
All Rights Reserved


*** History ***

2021-05-25     v1.78
[-] Fixed the using of external audio files (audio clips).
[*] Updated Spanish translation of README file (thanks to Fernando Gregoire).


2021-05-13     v1.77
[*] Updated the audio file saving.
[*] Updated the subtitle converting.


2021-05-06     v1.76
[-] Fixed the subtitle creating.


2021-04-08     v1.75
[+] Added the option to open a file with a list of input filenames.
[*] Updated the subtitle converting for SAPI 4.


2021-03-20     v1.74
[+] Added the options to insert blank lines after sentences and paragraphs in LRC files.


2021-02-23     v1.73
[+] Small improvements.


2021-01-24     v1.72
[+] Small improvements.


2020-11-28     v1.71
[+] Added the option to ignore URLs in text.
[-] Fixed the subtitle creating.


2020-11-22     v1.70
[+] Small improvements.
[*] The command line can contain more than one input text file name.


2020-09-13     v1.69
[+] Added the support of IPA phonetic transcription for BXD dictionaries.


2020-06-29     v1.68
[+] Added the support of LRC format for the subtitle converting.


2020-05-30     v1.67
[+] Added the support of WebVTT format for the subtitle converting.
[+] Small improvements.


2020-05-16     v1.66
[-] Fixed the using of SAPI 5.1 on Windows 7.


2020-05-10     v1.65
[+] Added the option to fix the subtitle converting via SAPI 5.
[+] Added the subtitle converting to audio files via SAPI 4.


2020-05-02     v1.64
[+] Small improvements.


2020-04-23     v1.63
[*] Some options were renamed and improved.


2020-04-21     v1.62
[+] Added options to read foreign text (an additional voice can be used to read foreign words).


2019-12-31     v1.61
[-] Fixed small bugs.


2019-12-29     v1.60
[+] Added the tag {{Voice}} to change a voice and its properties.


2019-12-25     v1.59
[-] Fixed the using of SAPI 5.1 on Windows XP.


2019-12-07     v1.58
[-] Fixed small bugs.


2019-10-08     v1.57
[-] Fixed small bugs.


2019-08-17     v1.56
[+] Small improvements.


2019-06-02     v1.55
[-] Fixed the option for pause/resume.


2019-05-12     v1.54
[-] Fixed the audio file saving if the audio output device is absent.


2019-04-03     v1.53
[-] Fixed the subtitle converting for SMI files.


2019-02-23     v1.52
[+] Added the options to ignore text in brackets.


2019-02-02     v1.51
[+] Small improvements.


2018-12-08     v1.50
[+] Added the option to ignore comments (single-line and multiline).
[*] The options "--deletefile" and "--ignorelength" were renamed to "--delete-file" and "--ignore-length" ("-il").


2018-11-25     v1.49
[*] An output file with visemes contains text splitted into words. A file encoding is UTF-8.


2018-10-15     v1.48
[-] Fixed the applying of rules.


2018-06-20     v1.47
[+] Small improvements.


2018-06-11     v1.46
[+] Added the option for pause/resume reading aloud by the active copy of the console application.
[*] If the command line contains text for reading and the input encoding is defined, the application will convert the input text.


2018-05-12     v1.45
[*] The multi-line modifier is specified by default for regular expressions.


2018-04-14     v1.44
[+] Added the support of BXD format for dictionaries.
[*] Updated Bulgarian translation of README file (thanks to Kostadin Kolev).


2018-03-31     v1.43
[+] Added the option for creating of text files with synchronized visemes.
[-] Fixed the voice selecting: if the value of the [-n] parameter is "elena", the application must select the voice "Elena", not "Helena".


2018-03-17     v1.42
[+] Small improvements.


2018-02-24     v1.41
[-] Fixed the subtitle converting to audio files for IVONA voices (when the speech rate is not equal to 0).


2018-02-01     v1.40
[+] Small improvements.


2017-11-25     v1.39
[*] The subtitle converting to audio files was improved.


2017-09-24     v1.38
[-] Fixed small bugs.


2017-08-24     v1.37
[+] Added the option for selecting of audio device by its name.


2017-06-10     v1.36
[-] Fixed small bugs.


2017-03-29     v1.35
[-] Fixed the creating of LRC and SRT files.


2017-02-11     v1.34
[+] Added the support of new operators for regular expresions (\U, \L, \E, \u, \l).


2017-02-05     v1.33
[-] Fixed the creating of LRC and SRT files.


2016-11-19     v1.32
[+] Added the options for creating of SRT files.


2016-10-15     v1.31
[*] The utility was renamed to "balcon.exe".
[-] Fixed small bugs.


2016-08-25     v1.30
[-] Fixed small bugs.


2016-05-28     v1.29
[+] Added the options for the output audio format.
[+] Small improvements.


2016-04-26     v1.28
[-] Fixed the reading of text from STDIN.


2016-03-12     v1.27
[+] Small improvements.


2016-01-03     v1.26
[-] Fixed small bugs.


2015-11-06     v1.25
[-] Fixed small bugs.


2015-07-05     v1.24
[-] Fixed small bugs.
[*] Updated Spanish translation of README file (thanks to Fernando Gregoire).


2015-06-07     v1.23
[*] Updated the applying of rules from REX-dictionaries.


2015-03-09     v1.22
[+] Added the option for selecting of text lines by their numbers.


2014-12-14     v1.21
[+] Added new messages about errors.


2014-08-30     v1.20
[+] Small improvements.


2014-04-24     v1.19
[+] Small improvements.
[*] Updated French translation of README file (thanks to Lyubov Tyurina).
[*] Updated Polish translation of README file (thanks to Natalia Atamanchuk).
[*] Updated Finnish, Portuguese and Spanish translations of README file.


2014-02-08     v1.18
[+] Added the option for closing of the active copy of the console application.
[+] Added the items "Pause" and "Next" to the context menu of the tray's icon.


2014-01-26     v1.17
[-] Fixed small bugs.


2014-01-19     v1.16
[+] Added the option for the program's icon in the system tray.
[+] Small improvements.
[*] Updated Bulgarian translation of README file (thanks to Kostadin Kolev).
[*] Updated German translation of README file (thanks to Regine Mueller).


2014-01-03     v1.15
[+] Small improvements.


2013-12-15     v1.14
[+] Added the option for text file deleting.
[*] Updated German translation of README file (thanks to Regine Mueller).


2013-10-02     v1.13
[*] Added the option for voice selecting by Locale ID.
[*] Updated German translation of README file (thanks to Regine Mueller).
[*] Updated French translation of README file (thanks to Lyubov Tyurina).


2013-09-24     v1.12
[*] The command line options were renamed.
[*] Updated Bulgarian translation of README file (thanks to Kostadin Kolev).


2013-09-22     v1.11
[+] Added the exit code = 1 for errors.


2013-08-25     v1.10
[+] Added the options for silence at the beginning/end of audio files.
[+] Added the using of audio clips (WAV) in text of documents.
[+] The library LIBSAMPLERATE.DLL is used.
[*] Updated German translation of README file (thanks to Regine Mueller).


2013-08-22     v1.09
[+] Added the option for input encoding.


2013-07-21     v1.08
[+] Added the options for subtitle converting to audio files.
[*] Updated German translation of README file (thanks to Regine Mueller).


2013-06-21     v1.07
[+] Small improvements.


2013-06-02     v1.06
[-] Fixed small bugs.


2013-04-06     v1.05
[+] Added the option for printing of the voice's parameters.
[+] Added the option for output as raw PCM data.
[+] Added the option for ignoring of data length in WAV header.
[+] The Polish translation of README file (thanks to Natalia Atamanchuk).
[*] Updated German translation of README file (thanks to Regine Mueller).
[*] Updated French translation of README file (thanks to Lyubov Tyurina).


2013-03-31     v1.04
[+] Added the options for creating of LRC files.
[*] Updated German translation of README file (thanks to Regine Mueller).


2013-03-27     v1.03
[+] Added the option for closing of other copies of the console application.
[+] Added the option for a queue of the application's copies.


2013-03-12     v1.02
[+] Added the option for audio device selection.
[*] Updated German translation of README file (thanks to Regine Mueller).
[*] Updated Bulgarian translation of README file (thanks to Kostadin Kolev).
[+] The French translation of README file (thanks to Lyubov Tyurina).
[+] The Finnish translation of README file.
[+] The Portuguese translation of README file.
[+] The Spanish translation of README file.


2013-03-03     v1.01
[+] Added the output to stdout for SAPI 5 and Microsoft Speech Platform.
[*] Updated German translation of README file (thanks to Regine Mueller).
[*] Updated Bulgarian translation of README file (thanks to Kostadin Kolev).


2013-02-26     v1.0
[+] The console application is available for downloading.
[+] The German translation of README file (thanks to Regine Mueller).
[+] The Bulgarian translation of README file (thanks to Kostadin Kolev).
tools\libsamplerate.dll
md5: 1C13E50AEC36BBB49B592089AD091128 | sha1: 75C46A3864FBE9C7401C980483D0DC323302A479 | sha256: 01BB04EC2D815CE30A5B4D9EDCADA479461D3DE31C78532468C398BC4C328505 | sha512: E85178779423E42B9AC4EF64B3A514E0CE5FEEF19B7B8DBAB2ED52A8D10E0EDC4268D96A74FF5A4C26C335DE81E283F023BD5DCB865C78FD625E3F3E1BFAD4FE
tools\readme.bul.txt
Balabolka (�������� ����������), ������ 1.78
�������� ����� (c) 2013-2021 ���� �������
������ ����� ��������

�������: http://balabolka.site/bg/bconsole.htm
�-����: [email protected]

������: ��������� (Freeware)
����������� �������: Microsoft Windows XP/Vista/7/8/10
����� ���: 4.0/5.0
Microsoft Speech Platform: 11.0



*** ��������� ***

balcon [����� ...]


*** ����� �� ��������� ��� ***

-l
   ������� �� ������ ������� � ��������� �������.

-g
   ������� �� ������ ������� � ������� ������� ����������.

-f <�������_����>
   ������ ����� �� ������� ������� ����. ��������� ��� ���� �� ������� ������ �� ���� [-f] �����.

-fl <���_��_����>
   Sets the name of the text file with the list of input files (one file name per line). ��������� ��� ���� �� ������� ������ �� ���� [-fl] �����.

-w <������_����>
   ������ ����� �� �������� ���� � WAV ������. ��� ������� � ��������, �� ���� �������� ����� ����. �����, ������ �� ���� �������� �� ����.

-n <���_��_�����>
   ������ ��� ���� �� ���� ��������� (����� �� ����� � ����������). ��� ������� �� � ��������, �� ���� ��������� ����� ������� �� ������������ � Windows.

-id <�����������_��������>
   ������ ����������� ������������� (Locale ID) �� �����. ������������ ������������� � �������� ���, ������� �� Microsoft
   (�������� "1026" ��� "0x0402" �� "���������", "1033" ��� "0x0409" �� "��������� - ���"). ���������� �� ������ ������ ���� ��� ������� ���������� ������������� �� ������� � �������.
   ��� ���� ��������� �� � ��������, ������ ������� � ����������� [-n] ��� ������ �� ������������ � Windows �� ���� ���������.
   �������� � ���������� ��������������, ���� �� ���� ������ �� ������� ��� �����:
   https://msdn.microsoft.com/en-us/library/cc233982.aspx

-m
   ������� �� ������ ����������� �� �����.

-b <����������� ��������>
   ������ ��������� ������� ���������� ������ ������� ������. �������� �� �������������� �� ������� ���������� � 0.

-r <�����>
   Sets the audio output device by its name.

-c
   �� ���� �� �������� ������ �� ���������.

-t <�����>
   �� ���� ���� �� �� �������� ����� �� ��������� ���. ��������� ��� ���� �� ������� ������ �� ���� [-t] �����.

-i
   �� ���� �� �������� ������ �� STDIN.

-o
   SAPI 4: �� �� ��������.
   SAPI 5 � Microsoft Speech Platform: ������� ��������� ����� � STDOUT; ��� � �������� ���� �����, ������� [-w] ���� ����������.

-s <�����������_��������>
   SAPI 4: ������ ��������� � ������ �� 0 �� 100 (���� �������� �� ������������).
   SAPI 5 � Microsoft Speech Platform: ������ ��������� � ������ �� -10 �� 10 (�� ������������ � 0).

-p <�����������_��������>
   SAPI 4: ������ ���������� �� ����� � ������ �� 0 �� 100 (���� �������� �� ������������).
   SAPI 5 � Microsoft Speech Platform: ������ ���������� �� ����� � ������ �� -10 �� 10 (�� ������������ � 0).

-v <�����������_��������>
   SAPI 4: �� �� ��������.
   SAPI 5 � Microsoft Speech Platform: ������ ������ �� ����� � ������ �� 0 �� 100 (�� ������������ � 100).

-e <�����������_��������>
   ������ ��������� �� ������� ����� ����������� (� �����������). �� ������������ � 0.

-a <�����������_��������>
   ������ ������� ����� �������� (� �����������). �� ������������ � 0.

-d <���_��_����>
   �������� �� ������ �� �������� �� �������������� (*.BXD, *.DIC ��� *.REX). ��������� ��� ���� �� ������� ������ �� ���� ����� [-d].

-k
   ���������� ��������� �� ����� ����� �� ������������ � ������� �� ���������.

-ka
   ���������� ������� �� ������ ���������� � ������� �� ��������� ����� �� ���������� ����������.

-pr
   Make pause or resume reading aloud by the active copy of the application. The action is the same as for the context menu item "Pause"/"Resume".

-q
   ������ ������������ � ������. ���������� ���������� �� ������ ������ ������� ����� �� ������������ ��������� � �������� ��.

-lrc
   SAPI 4: �� �� ��������.
   SAPI 5 � Microsoft Speech Platform: ������� LRC ����, ��� ����������� [-w] ��� [-o] �� ��������.

-srt
   SAPI 4: �� �� ��������.
   SAPI 5 � Microsoft Speech Platform: ������� SRT ����, ��� ����������� [-w] ��� [-o] �� ��������.

-vs <���_��_����>
   SAPI 4: �� �� ��������.
   SAPI 5 � Microsoft Speech Platform: ������ ����� �� �������� ������� ���� � ������, ��� ������� [-w] � �������.
   ������ � ������� �� ������, ����� ����������� �� ��������� ������ ����. SAPI �������� ������� �� 21 ������.
   ���� ������ � ������� �� ������������ ������ ��������� �� Disney. ������������ �� ������� ����� ����� � ���� ���� �� �� ������� �� ����, �� �� ������ �������� � ������� ������� ������.
   �������� � ���������� �� SAPI 5 ������: https://msdn.microsoft.com/en-us/library/ms720881(v=vs.85).aspx

-sub
   ������� �� ���� ���������� ���� ��������. ����������� ���� �� � �������, ������ �� �������� ����������� [-i] ��� [-c].

-tray
   ��������� �� ������� �� ���������� � �������� �� �����������. ���� �� ��������� �� ������� ��������� �� ������������� ������.
   ��������� "����" � ������������ ���� ���� �� �� �������� �� ������� �� �������.

-ln <�����������_��������>
   ������ ��� �� ��������� ���� ���� ������ �� ����. ������������ ������� �� "1".
   ���������� �� ������ ���� �� �� �������� �� �������� �� ������ �� ���� ��� (��������: "26-34").
   ��������� ��� ���� �� ������� ������ �� ���� ����� [-ln].

-fr <����������� ��������>
   SAPI 4: �� �� ��������.
   SAPI 5 � Microsoft Speech Platform: ������ ��������� ������� ������� � ��� (8, 11, 12, 16, 22, 24, 32, 44, 48).
   ��� ������� �� � �������, �� �� �������� ���������� �� ������������ �� �������� ����.

-bt <����������� ��������>
   SAPI 4: �� �� ��������.
   SAPI 5 � Microsoft Speech Platform: ������ ��������� ��������� �� ����� � ������ (8 ��� 16).
   ��� ������� �� � �������, �� �� �������� ���������� �� ������������ �� �������� ����.

-ch <����������� ��������>
   SAPI 4: �� �� ��������.
   SAPI 5 � Microsoft Speech Platform: ������ ���� �� ��������� ������� ������ (1 ��� 2).
   ��� ������� �� � �������, �� �� �������� ���������� �� ������������ �� �������� ����.

-? ��� -h
   ������� �� ������ ������� � ������������ ����� �� ��������� ���.

--encoding <��������> ��� -enc <��������>
   ������ ���������� �� ������� ����� ("ansi", "utf8" ��� "unicode"). ���������� �� ������������ � "ansi".

--silence-begin <�����������_��������> ��� -sb <�����������_��������>
   ������ ������������� �� �������� � �������� �� ����� ����� (� �����������). �� ������������ � 0.

--silence-end <�����������_��������> ��� -se <�����������_��������>
   ������ ������������� �� �������� � ���� �� ����� ����� (� �����������). �� ������������ � 0.

--lrc-length <�����������_��������>
   ������ ������������ ������� �� �������� � LRC ����� (� ���� �����).

--lrc-fname <���_��_����>
   ������ ����� �� LRC �����. ����������� �� ��� �������, ������ � ������� ���������� [-o].

--lrc-enc <��������>
   ������ ���������� �� LRC ����� ("ansi", "utf8" ��� "unicode"). ���������� �� ������������ � "ansi".

--lrc-offset <�����������_��������>
   ������ ��������� ���������� �� LRC ����� (� �����������).

--lrc-artist <�����>
   ������ ID ���� �� LRC �����: ����������.

--lrc-album <�����>
   ������ ID ���� �� LRC �����: �����.

--lrc-title <�����>
   ������ ID ���� �� LRC �����: ��������.

--lrc-author <�����>
   ������ ID ���� �� LRC �����: �����.

--lrc-creator <�����>
   ������ ID ���� �� LRC �����: �������� �� LRC �����.

--lrc-sent
   Inserts blank lines after sentences in the LRC file.

--lrc-para
   Inserts blank lines after paragraphs in the LRC file.

--srt-length <�����������_��������>
   ������ ������������ ������� �� �������� � SRT ����� (� ���� �����).

--srt-fname <���_��_����>
   ������ ����� �� SRT �����. ����������� �� ��� �������, ������ � ������� ���������� [-o].

--srt-enc <��������>
   ������ ���������� �� SRT ����� ("ansi", "utf8" ��� "unicode"). ���������� �� ������������ � "ansi".

--raw
   SAPI 4: �� �� ��������.
   SAPI 5 � Microsoft Speech Platform: ��������� ����� ���� � � ����� PCM ������; ����� ������� �� �������� WAV ����������. 
   ���� ��������� �� �������� � ���������� � ���������� [-o].

--ignore-length ��� -il
   SAPI 4: �� �� ��������.
   SAPI 5 � Microsoft Speech Platform: �������� ������������ ������� �� ����� � WAV ����������. 
   ���� ��������� �� �������� � ���������� � ���������� [-o].

--sub-format <�����>
   ������ ������� �� ���������� ("srt", "lrc", "ssa", "ass", "smi" ��� "vtt"). ��� ����������� �� � �������, �������� �� ���� ��������� ���� ��������� ����������.

--sub-fit ��� -sf
   SAPI 4: �� �� ��������.
   SAPI 5 � Microsoft Speech Platform: ����������� ��������� ���������, �� �� �������� � ��������� ��������� �� ���������� (������ ���������� ���������� �������� � ����� ����).

--sub-max <�����������_��������> ��� -sm <�����������_��������>
   SAPI 4: �� �� ��������.
   SAPI 5 � Microsoft Speech Platform: ������ ������������ ������� �� ����� � ������� �� -10 �� 10 (������ ���������� ���������� �������� � ����� ����).

--delete-file ��� -df
   �������� ��������� ����, ������ �������� ���� ���������. ���� ��������� �� �������� � ���������� � ���������� [-f].

--ignore-square-brackets ��� -isb
   Ignore text in [square brackets].

--ignore-curly-brackets ��� -icb
   Ignore text in {curly brackets}.

--ignore-angle-brackets ��� -iab
   Ignore text in <angle brackets>.

--ignore-round-brackets ��� -irb
   Ignore text in (round brackets).

--ignore-url ��� -iu
   Ignore URLs.

--ignore-comments ��� -ic
   Ignore comments in text. Single-line comments start with // and continue until the end of the line. Multiline comments start with /* and end with */.

--voice1-name <���_��_�����>
   SAPI 4: �� �� ��������.
   SAPI 5 � Microsoft Speech Platform: Sets the additional voice name to read foreign words in text (the part of the name will be enough).
   The option is used together with the option [--voice1-langid]. Other voices can be set by options [--voice2-name], [--voice3-name], etc.

--voice1-langid <�������������_��_�����>
   Sets the language ID for foreign words in text. The option is used together with the option [--voice1-name]. The command line may contain more than one option [--voice1-langid]. Also an option may contain a comma-separated list of IDs.
   The list of supported language IDs is based on ISO 639-1 codes: am, ar, az, ba, bg, be, ca, cs, cu, cv, da, de, el, en, es, et, eu, fi, fil, fr, ja, he, hi, hr, hu, hy, it, gn, gu, ka, kk-Cyr, kk-Lat, kn, ko, ky, lo, lt, lv, mk, no, pl, pt, ro, ru, sk, sl, sr-Cyr, sr-Lat, sv, tg, th, tr, tt, uk, zh.

--voice1-rate <�����������_��������>
   Sets the rate for the additional voice in a range of -10 to 10 (the default is 0).

--voice1-pitch <�����������_��������>
   Sets the pitch for the additional voice in a range of -10 to 10 (the default is 0).

--voice1-volume <�����������_��������>
   Sets the volume for the additional voice in a range of 0 to 100 (the default is 100).

--voice1-roman
   Use the default voice to read Roman numerals in text. If text with non-Latin characters contains Roman numerals, the application will not change a voice to read them. ��������: XIX ���, �������� II.

--voice1-digit
   Use the default voice to read numbers in text.

--voice1-length <�����������_��������>
   Set the minimal length of foreign text parts that will be read by the additional voice (in characters).


*** ������� ***

��������� �� ���� � ��� VOICE.TXT, �������� ������ � ������������� �������:

balcon -l > voice.txt


������� �� ���������������� �� ����� Microsoft Anna:

balcon -n "Microsoft Anna" -m


������������ �� ������ �� BOOK.TXT � ��� � ��������� ���� BOOK.WAV:

balcon -f "d:\Text\book.txt" -w "d:\Sound\book.wav" -n "Emma"


���������� �� ������ �� ���������, ��������� �� ������� �� �������� �� �������������� � ��������� �� ����:

balcon -n "Callie" -c -d "d:\rex\rules.rex" -d "d:\dic\rules.dic"


��������� �� ���� �� ����� �� ��������� ��� � ������� ������� � ���� �� �����:

balcon -n "Irina" -t "������� �� ���� �������� �����." -s -5 -v 70


������������ �� ��������� �� ����� ����� �� ������������ � ������� �� ���������:

balcon -k


������������ �� ����� �� STDIN � ���, ��������� ���� BOOK.WAV � ��������� �� BOOK.LRC:

balcon -f "d:\Text\book.txt" -w "d:\Sound\book.wav" -lrc --lrc-length 80 --lrc-title "The Lord of the Rings"


Read aloud English and Russian sentences by different voices:

balcon -f "d:\Text\book.txt" -n Kimberly --voice1-name Tatyana --voice1-langid ru


������������ �� �������� ��� FILM.WAV:

balcon -f "d:\Text\film.srt" -w "d:\Sound\film.wav" -n "Laura" --sub-fit --sub-max 2


������ �� ���������� � ���������� � LAME.EXE:

balcon -f d:\book.txt -n Irina -o --raw | lame -r -s 22.05 -m m -h - d:\book.mp3


������ �� ���������� � ���������� � OGGENC2.EXE:

balcon -f d:\book.txt -n Irina -o -il | oggenc2 --ignorelength - -o d:\book.ogg


������ �� ���������� � ���������� � WMAENCODE.EXE:

balcon -f d:\book.txt -n Irina -o -il | wmaencode - d:\book.wma --ignorelength


*** ��������������� ���� ***

������� �� ��������� ��� ���� �� ����� ��������� � ��������������� ���� � ��� "balcon.cfg" � ������ �����, � ����� � � ���������� ����������.

������ �� ��������������� ����:
===============
-f d:\Text\book.txt
-w d:\Sound\book.wav
-n Microsoft Anna
-s 2
-p -1
-v 95
-e 300
-d d:\Dict\rules.bxd
-lrc
--lrc-length 75
--lrc-enc utf8
--lrc-offset 300
===============

���������� ���� �� �������� ���������� �� ����� �� ���������������� ���� � �� ��������� ���.


*** ������� ������� ***

���������� ��������� ���������� �� ��������� ��� ������ WAV � MP3 ������� (������� �������) � ������. ����� �� ��������� �������, �� ��������� �� ������� �����:

{{Audio=C:\Sounds\ring.wav}}

��� ����������� �� ������ �� ����, ���������� �� ���� ������ ����� �� �������� ���� ���� ���������, �� ������������ �������� ���� � �� ������� �������� �� ����.
��� �������������� � ����� �������, ��������� ���� �� ���� ������� � ���������� �� ���������� ����� ����.


*** "Voice" Tag ***

If it is necessary to change a voice or its properties during reading aloud, a special tag can be used for SAPI 5 and Microsoft Speech Platform (SAPI 4 voices will ignore this tag).

The tag format:

{{Voice=Name;Rate;Pitch;Volume}}

- Name: the name of a voice (one word or the part of a word is enough);
- Rate: the rate of a voice (values range from -10 to 10);
- Pitch: the pitch of a voice (values range from -10 to 10);
- Volume: the volume (values range from 0 to 100).

A tag applies to all subsequent text. The values are separated by semicolons. For example:

This text will be spoken by the default voice of Balabolka. {{Voice=Kimberly;0;0;100}} The voice 'Kimberly' will read the other text.

The tag's content is case insensitive. Values for some properties can be omitted:

{{voice=eric;;;50}}

{{Voice=Hans;-1}}

{{Voice=Rachel}}

To return to the default voice, use this tag:

{{Voice=}}

Warning! It is impossible to switch between SAPI 5 voices and voices of the Microsoft Speech Platform.


*** "Pause" Tag ***

A specified number of milliseconds of silence can be inserted into the output audio file. For example:

One hundred twenty milliseconds of silence {{Pause=120}} just occurred.


*** ������ ***

You are free to use and distribute software for noncommercial purposes. For commercial use or distribution, you need to get permission from the copyright holder.

###
tools\readme.eng.txt
Balabolka (Command Line Utility), version 1.78
Copyright (c) 2013-2021 Ilya Morozov
All Rights Reserved

WWW: http://balabolka.site/bconsole.htm
E-mail: [email protected]

Licence: Freeware
Operating System: Microsoft Windows XP/Vista/7/8/10
Microsoft Speech API: v4.0/5.0 and above
Microsoft Speech Platform: v11.0



*** Usage ***

balcon [options ...]


*** Command Line Options ***

-l
   Prints the list of available voices.

-g
   Prints the list of available audio output devices.

-f <file_name>
   Sets the name of the input text file. The command line may contain few options [-f].

-fl <file_name>
   Sets the name of the text file with the list of input files (one file name per line). The command line may contain few options [-fl].

-w <file_name>
   Sets the name of the output file in WAV format. If the option is specified, an audio file will be created. Otherwise, text will be read aloud.

-n <voice_name>
   Sets the voice name (the part of the name will be enough). If the option is not specified, the voice, defined by the option [-id], or the default voice of Windows will be used.

-id <integer>
   Sets Locale ID for the voice. Locale ID is the language code, assigned by Microsoft (for example, "1033" or "0x0409" for "English - United States", "2057" or "0x0809" for "English - United Kingdom").
   The program will choose the first voice with specified Locale ID from the list of voices. If the option is not specified, the voice, defined by the option [-n], or the default voice of Windows will be used.
   The list of Locale IDs: https://msdn.microsoft.com/en-us/library/cc233982.aspx

-m
   Prints the parameters of the voice.

-b <integer>
   Sets the audio output device by its index. The index of the default audio device is 0.

-r <text>
   Sets the audio output device by its name.

-c
   Takes the text input from clipboard.

-t <text>
   Text input can be taken from the command line. The command line may contain few options [-t].

-i
   Takes the text input from STDIN.

-o
   SAPI 4: not used.
   SAPI 5 and Microsoft Speech Platform: writes sound data to STDOUT; if the option is specified, the option [-w] is ignored.

-s <integer>
   SAPI 4: sets the rate in a range of 0 to 100 (no default value).
   SAPI 5 and Microsoft Speech Platform: sets the rate in a range of -10 to 10 (the default is 0).

-p <integer>
   SAPI 4: sets the pitch in a range of 0 to 100 (no default value).
   SAPI 5 and Microsoft Speech Platform: sets the pitch in a range of -10 to 10 (the default is 0).

-v <integer>
   SAPI 4: not used.
   SAPI 5 and Microsoft Speech Platform: sets the volume in a range of 0 to 100 (the default is 100).

-e <integer>
   Sets the length of pauses between sentences (in milliseconds). The default is 0.

-a <integer>
   Sets the length of pauses between paragraphs (in milliseconds). The default is 0.

-d <file_name>
   Applies a dictionary for pronunciation correction (*.BXD, *.DIC or *.REX). The command line may contain few options [-d].
   You may use the desktop application 'Balabolka' to edit a dictionary.

-k
   Kills other copies of the application in the computer's memory.

-ka
   Kills the active copy of the application in the computer's memory.

-pr
   Make pause or resume reading aloud by the active copy of the application. The action is the same as for the context menu item "Pause"/"Resume".

-q
   Adds the application to a queue. The utility will wait until other copies of the application have finished.

-lrc
   SAPI 4: not used.
   SAPI 5 and Microsoft Speech Platform: creates the LRC file, if the option [-w] or [-o] is specified.

-srt
   SAPI 4: not used.
   SAPI 5 and Microsoft Speech Platform: creates the SRT file, if the option [-w] or [-o] is specified.

-vs <file_name>
   SAPI 4: not used.
   SAPI 5 and Microsoft Speech Platform: sets the name of output text file with visemes, if the option [-w] is specified.
   A viseme is the mouth shape that corresponds to a particular speech sound. SAPI supports the list of 21 visemes.
   This list is based on the original Disney visemes. The application will create the audio file and then read it aloud to get visemes and their timecodes.
   The list of visemes supported by SAPI 5: https://msdn.microsoft.com/en-us/library/ms720881(v=vs.85).aspx

-sub
   Input text will be processed as subtitles. The option may be useful, when the options [-i] or [-c] are specified.

-tray
   Show the application's icon in the system tray. This allows to view the progress of the task.
   The context menu item "Stop" can be used to stop the process.

-ln <integer>
   Selects a line from the text file by using of a line number. The line numbering starts at "1".
   The interval of numbers can be used for selecting of more than one line (for example, "26-34").
   The command line may contain more than one option [-ln].

-fr <integer>
   SAPI 4: not used.
   SAPI 5 and Microsoft Speech Platform: sets the output audio sampling frequency in kHz (8, 11, 12, 16, 22, 24, 32, 44, 48).
   If the option is not specified, the default value for the selected voice will be used.

-bt <integer>
   SAPI 4: not used.
   SAPI 5 and Microsoft Speech Platform: sets the output audio bit depth (8 or 16).
   If the option is not specified, the default value for the selected voice will be used.

-ch <integer>
   SAPI 4: not used.
   SAPI 5 and Microsoft Speech Platform: sets the output audio channel mode (1 or 2).
   If the option is not specified, the default value for the selected voice will be used.

-? or -h
   Prints the list of available command line options.

--encoding <encoding> or -enc <encoding>
   Sets the input text encoding ("ansi", "utf8" or "unicode"). The default is "ansi".

--silence-begin <integer> or -sb <integer>
   Sets the length of silence at the beginning of the audio file (in milliseconds). The default is 0.

--silence-end <integer> or -se <integer>
   Sets the length of silence at the end of the audio file (in milliseconds). The default is 0.

--lrc-length <integer>
   Sets the maximal length of text lines for the LRC file (in characters).

--lrc-fname <file_name>
   Sets the name of the LRC file that will be created. The option may be useful, when the option [-o] is specified.

--lrc-enc <encoding>
   Sets the encoding for the LRC file ("ansi", "utf8" or "unicode"). The default is "ansi".

--lrc-offset <integer>
   Sets the time shift for the LRC file (in milliseconds).

--lrc-artist <text>
   Sets the ID tag for the LRC file: artist.

--lrc-album <text>
   Sets the ID tag for the LRC file: album.

--lrc-title <text>
   Sets the ID tag for the LRC file: title.

--lrc-author <text>
   Sets the ID tag for the LRC file: author.

--lrc-creator <text>
   Sets the ID tag for the LRC file: creator of the LRC file.

--lrc-sent
   Inserts blank lines after sentences when creating the LRC file.

--lrc-para
   Inserts blank lines after paragraphs when creating the LRC file.

--srt-length <integer>
   Sets the maximal length of text lines for the SRT file (in characters).

--srt-fname <file_name>
   Sets the name of the SRT file. The option may be useful, when the option [-o] is specified.

--srt-enc <encoding>
   Sets the encoding for the SRT file ("ansi", "utf8" or "unicode"). The default is "ansi".

--raw
   SAPI 4: not used.
   SAPI 5 and Microsoft Speech Platform: output is raw PCM; audio data does not contain the WAV header.
   The option is used together with the option [-o].

--ignore-length or -il
   SAPI 4: not used.
   SAPI 5 and Microsoft Speech Platform: omits the length of data in the WAV header.
   The option is used together with the option [-o].

--sub-format <text>
   Sets the format of input subtitles ("srt", "lrc", "ssa", "ass", "smi" or "vtt"). If the option is not specified, the format will be determined through the file extension.

--sub-fit or -sf
   SAPI 4: not used.
   SAPI 5 and Microsoft Speech Platform: automatically increases the speed to fit time intervals (when the program converts subtitles to audio file).

--sub-max <integer> or -sm <integer>
   SAPI 4: not used.
   SAPI 5 and Microsoft Speech Platform: sets the maximal speed of speech in a range of -10 to 10 (when the program converts subtitles to audio file).

--delete-file or -df
   Removes the text file, when job is done. The option is used together with the option [-f].

--ignore-square-brackets or -isb
   Ignore text in [square brackets].

--ignore-curly-brackets or -icb
   Ignore text in {curly brackets}.

--ignore-angle-brackets or -iab
   Ignore text in <angle brackets>.

--ignore-round-brackets or -irb
   Ignore text in (round brackets).

--ignore-url or -iu
   Ignore URLs.

--ignore-comments or -ic
   Ignore comments in text. Single-line comments start with // and continue until the end of the line. Multiline comments start with /* and end with */.

--voice1-name <voice_name>
   SAPI 4: not used.
   SAPI 5 and Microsoft Speech Platform: sets the additional voice name to read foreign words in text (the part of the name will be enough).
   The option is used together with the option [--voice1-langid]. Other voices can be set by options [--voice2-name], [--voice3-name], etc.

--voice1-langid <language_id>
   Sets the language ID for foreign words in text. The option is used together with the option [--voice1-name]. The command line may contain more than one option [--voice1-langid]. Also an option may contain a comma-separated list of IDs.
   The list of supported language IDs is based on ISO 639-1 codes: am, ar, az, ba, bg, be, ca, cs, cu, cv, da, de, el, en, es, et, eu, fi, fil, fr, ja, he, hi, hr, hu, hy, it, gn, gu, ka, kk-Cyr, kk-Lat, kn, ko, ky, lo, lt, lv, mk, no, pl, pt, ro, ru, sk, sl, sr-Cyr, sr-Lat, sv, tg, th, tr, tt, uk, zh.

--voice1-rate <integer>
   Sets the rate for the additional voice in a range of -10 to 10 (the default is 0).

--voice1-pitch <integer>
   Sets the pitch for the additional voice in a range of -10 to 10 (the default is 0).

--voice1-volume <integer>
   Sets the volume for the additional voice in a range of 0 to 100 (the default is 100).

--voice1-roman
   Use the default voice to read Roman numerals in text. If text with non-Latin characters contains Roman numerals, the application will not change a voice to read them.

--voice1-digit
   Use the default voice to read numbers in text.

--voice1-length <integer>
   Set the minimal length of foreign text parts that will be read by the additional voice (in characters).


*** Examples ***

Create the text file VOICE.TXT with the list of the installed voices:

balcon -l > voice.txt


View the specifications of the Microsoft Anna voice:

balcon -n "Microsoft Anna" -m


Convert text from BOOK.TXT to speech and save as BOOK.WAV:

balcon -f "d:\Text\book.txt" -w "d:\Sound\book.wav" -n Emma


Get text from the clipboard, apply rules for the pronunciation correction and read aloud:

balcon -n Callie -c -d "d:\rex\rules.rex" -d "d:\dic\rules.dic"


Read aloud text from the command line with specified rate and volume:

balcon -n Emily -t "The text will be read slowly." -s -5 -v 70


Kill other copies of the application in the computer's memory:

balcon -k


Convert text from STDIN to speech, save as BOOK.WAV and create BOOK.LRC:

balcon -w "d:\book.wav" -i -lrc --lrc-length 80 --lrc-title "The Lord of the Rings"


Read aloud English, Russian and Belarusian sentences by different voices:

balcon -f "d:\Text\book.txt" -n Kimberly --voice1-name Tatyana --voice1-langid ru,be


Convert subtitles to FILM.WAV:

balcon -f "d:\Text\film.srt" -w "d:\Sound\film.wav" -n Laura --sub-fit --sub-max 2


The example of use together with LAME.EXE:

balcon -f d:\book.txt -n Heather -o --raw | lame -r -s 22.05 -m m -h - d:\book.mp3


The example of use together with OGGENC2.EXE:

balcon -f d:\book.txt -n Heather -o -il | oggenc2 --ignorelength - -o d:\book.ogg


The example of use together with WMAENCODE.EXE:

balcon -f d:\book.txt -n Heather -o -il | wmaencode - d:\book.wma --ignorelength


*** Configuration File ***

The command line options can be stored as a configuration file "balcon.cfg" in the same folder as the utility.

The sample configuration file:
===============
-f d:\Text\book.txt
-w d:\Sound\book.wav
-n Microsoft Anna
-s 2
-p -1
-v 95
-e 300
-d d:\Dict\rules.bxd
-lrc
--lrc-length 75
--lrc-enc utf8
--lrc-offset 300
===============

The utility may combine options from the configuration file and the command line.


*** Audio Clips ***

The application allows to insert links to external WAV and MP3 files (audio clips) into text. Audio clip tag will look like:

{{Audio=C:\Sounds\ring.wav}}

When speaking text aloud, the utility will pause when the audio clip tag is reached, play the audio clip and resume speaking.
When converting to audio files, the audio clip will be embedded in the audio file created by the application.


*** "Voice" Tag ***

If it is necessary to change a voice or its properties during reading aloud, a special tag can be used for SAPI 5 and Microsoft Speech Platform (SAPI 4 voices will ignore this tag).

The tag format:

{{Voice=Name;Rate;Pitch;Volume}}

- Name: the name of a voice (one word or the part of a word is enough);
- Rate: the rate of a voice (values range from -10 to 10);
- Pitch: the pitch of a voice (values range from -10 to 10);
- Volume: the volume (values range from 0 to 100).

A tag applies to all subsequent text. The values are separated by semicolons. For example:

This text will be spoken by the default voice of Balabolka. {{Voice=Kimberly;0;0;100}} The voice 'Kimberly' will read the other text.

The tag's content is case insensitive. Values for some properties can be omitted:

{{voice=eric;;;50}}

{{Voice=Hans;-1}}

{{Voice=Rachel}}

To return to the default voice, use this tag:

{{Voice=}}

Warning! It is impossible to switch between SAPI 5 voices and voices of the Microsoft Speech Platform.


*** "Pause" Tag ***

A specified number of milliseconds of silence can be inserted into the output audio file. For example:

One hundred twenty milliseconds of silence {{Pause=120}} just occurred.


*** Licence ***

You are free to use and distribute software for noncommercial purposes. For commercial use or distribution, you need to get permission from the copyright holder. The application can not be used on the territory of Belarus, Cuba, Iran, North Korea, Syria, and the Crimea Region.

###
tools\readme.fin.txt
Balabolka (komentorivisovellus), versio 1.78
Copyright (c) 2013-2021 Ilya Morozov
All Rights Reserved

WWW: http://balabolka.site/fi/bconsole.htm
E-mail: [email protected]

Lisenssi: Freeware
K�ytt�j�restelm�: Microsoft Windows XP/Vista/7/8/10
Microsoft Speech API: v4.0/5.0
Microsoft Speech Platform: v11.0



*** Komentorivi ***

balcon [options ...]


*** Komentoriviparametrit ***

-l
   N�yt� kaikki tietokoneella olevat ��net.

-g
   N�yt� kaikki saatavilla olevat audiolaitteet.

-f <tiedoston_nimi>
   Avaa tekstitiedosto. Komentoon voi sis�lty� muutama [-f] -parametri.

-fl <tiedoston_nimi>
   Sets the name of the text file with the list of input files (one file name per line). Komentoon voi sis�lty� muutama [-fl] -parametri.

-w <tiedoston_nimi>
   Kirjoittaa WAV-��nitiedosto. Jos t�m� parametri on sy�ty, luodaan ��nitiedosto. Jos parametria ei ole, teksti� luetaan ��neen.

-n <��nen_nimi>
   ��nen nimi (nimenosa riitt��). Jos t�t� parametria ei ole, k�ytet��n Windowsin ohjauspaneelilla valittu ��ni.
   If the option is not specified, the voice, defined by the option [-id], or the default voice of Windows will be used.

-id <luku>
   Valita tietokoneen ��ni kielitunnisteen avulla (Locale ID).
   Microsoftin kehitt�j�t my�nsiv�t sellaiset tunnisteet kaikille kielille (esimerkiksi, "1033" tai "0x0409" on englannin kielen tunniste ja "1035" tai "0x040B" � suomen kielen tunniste).
   Ohjelma valitsee listalta ensimm�isen ��nen, jonka kielitunniste vastaa tarvittavaan koodiin. Jos parametri ei ole annettu, niin k�ytet��n ��nt�, joka annettiin [�n] -parametrin avulla, tai ��nt�, joka valittiin Windowsin ohjauspaneelista.
   Tunnisteiden lista: https://msdn.microsoft.com/en-us/library/cc233982.aspx

-m
   N�ytt�� valitun ��nen parametrit.

-b <luku>
   Valitse audiolaite sen numeron mukaan saatavilla olevien laitteiden listasta ��nen esitt�miseen. Oletuslaitteen numero on 0.

-r <tekstin_rivi>
   Sets the audio output device by its name.

-c
   K�yt� leikep�yd�ss� oleva teksti.

-t <tekstin_rivi>
   K�yt� komentoriviss� oleva teksti. Komentoon voi sis�lty� muutama [-t] -parametri.

-i
   K�yt� standardisy�tt�virrassa oleva teksti (STDIN).

-o
   SAPI 4: parametria ei k�ytett�viss�.
   SAPI 5 ja Microsoft Speech Platform: kirjoita ��nitieto standarditulostevirtaan (STDOUT); jos parametri on mainittu, parametri [-w] on v�litt�m�tt�.

-s <luku>
   SAPI 4: asenna ��ninopeudeksi luku 0...100 (oletusnopeutta ei ole).
   SAPI 5 ja Microsoft Speech Platform: asenna ��ninopeudeksi luku -10...10 (oletusnopeus on 0).

-p <luku>
   SAPI 4: asenna ��nens�vyksi luku 0...100 (oletuss�vy� ei ole).
   SAPI 5 ja Microsoft Speech Platform: asenna ��nens�vyksi luku -10...10 (oletuss�vy on 0).

-v <luku>
   SAPI 4: parametria ei k�ytett�viss�.
   SAPI 5 ja Microsoft Speech Platform: asenna ��nenvoimakkuudeksi luku 0...100 (oletusvoimakkuus on 100).

-e <luku>
   Asenna lauseiden v�liseksi taukopituudeksi sy�tetty luku (yksikk�n� on millisekunti). Oletuspituus on 0.

-a <luku>
   Asenna kappaleiden v�liseksi taukopituudeksi sy�tetty luku (yksikk�n� on millisekunti). Oletuspituus on 0.

-d <tiedoston_nimi>
   K�yt� sanakirja ��nt�myksen korjaamiseksi (tiedostolaajennus *.BXD, *.DIC tai *.REX). Komentoon voi sis�lty� muutama [-d] -parametri.

-k
   Lopettaa muiden tietokoneella toimivien konsolisovellusten toimintaa.

-ka
   Lopettaa nykyhetkess� aktiivisena olevan konsolisovelluksen toimintaa.

-pr
   Make pause or resume reading aloud by the active copy of the application. The action is the same as for the context menu item "Pause"/"Resume".

-q
   Lis�t� sovellus jonoon. Konsolisovellus odottaa kunnes muut ohjelmat lopettavat toimintaan.

-lrc
   SAPI 4: parametria ei k�ytett�viss�.
   SAPI 5 ja Microsoft Speech Platform: luoda LRC-muotoinen tiedosto, jos on annettu [�w] tai [�o] �parametrit.

-srt
   SAPI 4: parametria ei k�ytett�viss�.
   SAPI 5 ja Microsoft Speech Platform: luoda SRT-muotoinen tiedosto, jos on annettu [�w] tai [�o] �parametrit.

-vs <tiedoston_nimi>
   SAPI 4: parametria ei k�ytett�viss�.
   SAPI 5 ja Microsoft Speech Platform: sets the name of output text file with visemes, if the option [-w] is specified.
   A viseme is the mouth shape that corresponds to a particular speech sound. SAPI supports the list of 21 visemes.
   This list is based on the original Disney visemes. The application will create the audio file and then read it aloud to get visemes and their timecodes.
   The list of visemes supported by SAPI 5: https://msdn.microsoft.com/en-us/library/ms720881(v=vs.85).aspx

-sub
   Tekstin muotona on tekstitys, joka pit�� muuttaa ��nitiedostoksi ottaen huomioon annetut v�liajat.

-tray
   N�ytt�� ohjelman kuvake k�ytt�j�rjestelm�n tiedotusten alueella.
   Se antaa k�ytt�j�lle mahdollisuutta seurata operaation suorittamista, sek� lopettaa prosessi pikavalikon "Stop"-kohdan avulla.

-ln <luku>
   Selects a line from the text file by using of a line number. The line numbering starts at "1".
   The interval of numbers can be used for selecting of more than one line (for example, "26-34").
   Komentoon voi sis�lty� muutama [-ln] -parametri.

-fr <luku>
   SAPI 4: parametria ei k�ytett�viss�.
   SAPI 5 ja Microsoft Speech Platform: sets the output audio sampling frequency in kHz (8, 11, 12, 16, 22, 24, 32, 44, 48).
   If the option is not specified, the default value of the selected voice will be used.

-bt <luku>
   SAPI 4: parametria ei k�ytett�viss�.
   SAPI 5 ja Microsoft Speech Platform: sets the output audio bit depth (8 tai 16).
   If the option is not specified, the default value of the selected voice will be used.

-ch <luku>
   SAPI 4: parametria ei k�ytett�viss�.
   SAPI 5 ja Microsoft Speech Platform: sets the output audio channel mode (1 tai 2).
   If the option is not specified, the default value of the selected voice will be used.

-? tai -h
   N�yt� kaikki mahdolliset parametrit.

--encoding <merkist�> tai �enc <merkist�>
   Tekstin koodaus tavallisesta sy�tt�virrasta ("ansi", "utf8" tai "unicode"). Oletuksena parametri on "ansi".

--silence-begin <luku> tai -sb <luku>
   M��ritt�� ��nitiedoston alussa olevan tauon pituus (millisekunneissa). Oletuspituus on 0.

--silence-end <luku> tai -se <luku>
   M��ritt�� ��nitiedoston lopussa olevan tauon pituus (millisekunneissa). Oletuspituus on 0.

--lrc-length <luku>
   M��ritt�� LRC-muotoisen tiedoston maksimaalinen rivin pituus (symboleissa).

--lrc-fname <tiedoston_nimi>
   LRC-muotoisen tiedoston nimi. T�m� parametri voi olla hy�dyllinen niiss� tapauksissa, kun komentoriviss� on annettu parametri [�o].

--lrc-enc <merkist�>
   LRC-muotoisen tiedoston koodaus ("ansi", "utf8" tai "unicode"). Oletuksena parametri on "ansi".

--lrc-offset <luku>
   Antaa ajansiirto LRC-muotoiselle tiedostolle (millisekunneissa).

--lrc-artist <tekstin_rivi>
   LRC-muotoisen tiedoston tag: teoksen esitt�j�.

--lrc-album <tekstin_rivi>
   LRC-muotoisen tiedoston tag: albumi.

--lrc-title <tekstin_rivi>
   LRC-muotoisen tiedoston tag: teoksen nimi.

--lrc-author <tekstin_rivi>
   LRC-muotoisen tiedoston tag: luoja.

--lrc-creator <tekstin_rivi>
   LRC-muotoisen tiedoston tag: tiedoston luoja.

--lrc-sent
   Inserts blank lines after sentences in the LRC file.

--lrc-para
   Inserts blank lines after paragraphs in the LRC file.

--srt-length <luku>
   M��ritt�� SRT-muotoisen tiedoston maksimaalinen rivin pituus (symboleissa).

--srt-fname <tiedoston_nimi>
   SRT-muotoisen tiedoston nimi. T�m� parametri voi olla hy�dyllinen niiss� tapauksissa, kun komentoriviss� on annettu parametri [�o].

--srt-enc <merkist�>
   SRT-muotoisen tiedoston koodaus ("ansi", "utf8" tai "unicode"). Oletuksena parametri on "ansi".

--raw
   SAPI 4: parametria ei k�ytett�viss�.
   SAPI 5 ja Microsoft Speech Platform: tallentaa ��nitiedostot RAW PCM-muotoon; tiedostot eiv�t sis�ll� WAV-muotoista otsikkoa.
   Parametria k�ytet��n [�o] -parametrin parissa.

--ignore-length tai -il
   SAPI 4: parametria ei k�ytett�viss�.
   SAPI 5 ja Microsoft Speech Platform: ei kirjoita ��nitiedoston kokoa WAV-muotoiseen otsikkoon.
   Parametria k�ytet��n [�o] -parametrin parissa.

--sub-format <tekstin_rivi>
   Tekstityksen muoto ("srt", "lrc", "ssa", "ass", "smi" tai "vtt"). Jos parametri ei ole annettu, niin parametri m��ritet��n tekstityksen tiedostop��tteen mukaan.

--sub-fit tai -sf
   SAPI 4: parametria ei k�ytett�viss�.
   SAPI 5 ja Microsoft Speech Platform: lis�t� automaattisesti puheen nopeutta pysy�kseen tekstityksess� annettujen v�liaikojen rajoissa.

--sub-max <luku> tai -sm <luku>
   SAPI 4: parametria ei k�ytett�viss�.
   SAPI 5 ja Microsoft Speech Platform: m��ritt�� maksimaalinen puheen nopeus ��nialueella -10:st� 10:een (muuttaakseen tekstitys ��nitiedostoksi).

--delete-file tai -df
   Poistaa tekstitiedosto ��neen lukemisen tai ��nitiedoston tallentamisen j�lkeen.

--ignore-square-brackets tai -isb
   Ignore text in [square brackets].

--ignore-curly-brackets tai -icb
   Ignore text in {curly brackets}.

--ignore-angle-brackets tai -iab
   Ignore text in <angle brackets>.

--ignore-round-brackets tai -irb
   Ignore text in (round brackets).

--ignore-url tai -iu
   Ignore URLs.

--ignore-comments tai -ic
   Ignore comments in text. Single-line comments start with // and continue until the end of the line. Multiline comments start with /* and end with */.

--voice1-name <��nen_nimi>
   SAPI 4: parametria ei k�ytett�viss�.
   SAPI 5 ja Microsoft Speech Platform: sets the additional voice name to read foreign words in text (the part of the name will be enough).
   The option is used together with the option [--voice1-langid]. Other voices can be set by options [--voice2-name], [--voice3-name], etc.

--voice1-langid <kielen tunnus>
   Sets the language ID for foreign words in text. The option is used together with the option [--voice1-name]. The command line may contain more than one option [--voice1-langid]. Also an option may contain a comma-separated list of IDs.
   The list of supported language IDs is based on ISO 639-1 codes: am, ar, az, ba, bg, be, ca, cs, cu, cv, da, de, el, en, es, et, eu, fi, fil, fr, ja, he, hi, hr, hu, hy, it, gn, gu, ka, kk-Cyr, kk-Lat, kn, ko, ky, lo, lt, lv, mk, no, pl, pt, ro, ru, sk, sl, sr-Cyr, sr-Lat, sv, tg, th, tr, tt, uk, zh.

--voice1-rate <luku>
   Sets the rate for the additional voice in a range of -10 to 10 (the default is 0).

--voice1-pitch <luku>
   Sets the pitch for the additional voice in a range of -10 to 10 (the default is 0).

--voice1-volume <luku>
   Sets the volume for the additional voice in a range of 0 to 100 (the default is 100).

--voice1-roman
   Use the default voice to read Roman numerals in text. If text with non-Latin characters contains Roman numerals, the application will not change a voice to read them.

--voice1-digit
   Use the default voice to read numbers in text.

--voice1-length <luku>
   Set the minimal length of foreign text parts that will be read by the additional voice (in characters).


*** Esimerkkej� ***

balcon -l

balcon -n "Microsoft Anna" -m

balcon -f "d:\Text\book.txt" -w "d:\Sound\book.wav" -n "Emma"

balcon -n "Callie" -c -d "d:\rex\rules.rex" -d "d:\dic\rules.dic"

balcon -n "Sanna" -t "Teksi luetaan hitaasti." -s -5 -v 70

balcon -k

balcon -f "d:\Text\book.txt" -w "d:\Sound\book.wav" -lrc --lrc-length 80 --lrc-title "The Lord of the Rings"

balcon -f "d:\Text\film.srt" -w "d:\Sound\film.wav" -n "Laura" --sub-fit --sub-max 2

balcon -f "d:\Text\book.txt" -n Kimberly --voice1-name Tatyana --voice1-langid ru


Esimerkki sovelluksen k�ytt�mist� LAME.EXE �apuohjelman parissa:

balcon -f d:\book.txt -n Sanna -o --raw | lame -r -s 22.05 -m m -h - d:\book.mp3


Esimerkki sovelluksen k�ytt�mist� OGGENC2.EXE �apuohjelman parissa:

balcon -f d:\book.txt -n Sanna -o -il | oggenc2 --ignorelength - -o d:\book.ogg


Esimerkki sovelluksen k�ytt�mist� WMAENCODE.EXE �apuohjelman parissa:

balcon -f d:\book.txt -n Sanna -o -il | wmaencode - d:\book.wma --ignorelength


*** Konfiguraatiotiedosto ***

Parametrit voi tallentaa "balcon.cfg" -nimiseen konfiguraatiotiedostoon, joka sijaitsee sovelluksen kansiossa.

Tiedoston sis�llyksen esimerkki:
===============
-f d:\Text\book.txt
-w d:\Sound\book.wav
-n Microsoft Anna
-s 2
-p -1
-v 95
-e 300
-d d:\Dict\rules.bxd
-lrc
--lrc-length 75
--lrc-enc utf8
--lrc-offset 300
===============

Sovellus voi yhdist�� konfiguraatiotiedostossa olevat ja komentorivin parametrit.


*** Audio Clips ***

The application allows to insert links to external WAV files (audio clips) into text. Audio clip tag will look like:

{{Audio=C:\Sounds\ring.wav}}

When speaking text aloud, the program will pause when the audio clip tag is reached, play the audio clip and resume speaking.
When converting to audio files, the audio clip will be embedded in the audio file created by the application.


*** "Voice" Tag ***

If it is necessary to change a voice or its properties during reading aloud, a special tag can be used for SAPI 5 and Microsoft Speech Platform (SAPI 4 voices will ignore this tag).

The tag format:

{{Voice=Name;Rate;Pitch;Volume}}

- Name: the name of a voice (one word or the part of a word is enough);
- Rate: the rate of a voice (values range from -10 to 10);
- Pitch: the pitch of a voice (values range from -10 to 10);
- Volume: the volume (values range from 0 to 100).

A tag applies to all subsequent text. The values are separated by semicolons. For example:

This text will be spoken by the default voice of Balabolka. {{Voice=Kimberly;0;0;100}} The voice 'Kimberly' will read the other text.

The tag's content is case insensitive. Values for some properties can be omitted:

{{voice=eric;;;50}}

{{Voice=Hans;-1}}

{{Voice=Rachel}}

To return to the default voice, use this tag:

{{Voice=}}

Warning! It is impossible to switch between SAPI 5 voices and voices of the Microsoft Speech Platform.


*** "Pause" Tag ***

A specified number of milliseconds of silence can be inserted into the output audio file. For example:

One hundred twenty milliseconds of silence {{Pause=120}} just occurred.


*** Lisenssi ***

Sovelluksen kaupallinen k�ytt�oikeus:
- toiminimelle rajoituksetta;
- oikeushenkil�it� koskevat rajoitukset on mainittu Balabolkan lisenssisopimuksessa.

Sovelluksen kaupallinen k�ytt� sallittu ainoastaan oikeudenomistajan luvasta.

###
tools\readme.fra.txt
Balabolka (application console), version 1.78
Copyright (c) 2013-2021 Ilya Morozov
All Rights Reserved

WWW : http://balabolka.site/fr/bconsole.htm
E-mail : [email protected]

Licence : Freeware
Syst�me d'exploitation : Microsoft Windows XP/Vista/7/8/10
Microsoft Speech API: v4.0/5.0 and above
Microsoft Speech Platform: v11.0



*** Ligne de commande ***

balcon [options ...]


*** Param�tres de ligne de commande ***

-l
   Affiche la liste des voix disponibles.

-g
   Affiche la liste des p�riph�riques de sortie audio disponibles.

-f <nom_de_fichier>
   Sp�cifie le nom du fichier texte d'entr�e. La ligne de commande peut contenir quelques options [-f].

-fl <nom_de_fichier>
   Sets the name of the text file with the list of input files (one file name per line). La ligne de commande peut contenir quelques options [-fl].

-w <nom_de_fichier>
   Sp�cifie le nom du fichier de sortie au format WAV. Si l'option est sp�cifi�e, un fichier audio sera cr��. Dans le cas contraire, le texte sera lu � haute voix.

-n <nom_de_voix>
   Sp�cifie le nom de la voix (la partie du nom est suffisant). 
   Si le param�tre n'est pas sp�cifi�, la voix d�finie par le param�tre [-id] ou la voix par d�faut de Windows sera utilis�e.

-id <nombre_int�gral>
   Sp�cifier le code de langue pour la voix (Locale ID). Locale ID est le code de langue attribu� par Microsoft
   (par exemple "1033" ou "0x0409" pour Anglais - �tats-Unis", "1036" ou "0x040C" pour "Fran�ais - France").
   Le logiciel choisit dans la liste de voix la premi�re voix avec l'ID sp�cifi�.
   Si le param�tre n'est pas sp�cifi�, la voix d�finie par le param�tre [-n] ou la voix par d�faut de Windows sera utilis�e.
   La liste de pays avec leurs Locale ID : https://msdn.microsoft.com/en-us/library/cc233982.aspx

-m
   Affiche les param�tres de la voix.

-b <nombre_int�gral>
   Sp�cifie le p�riph�rique audio par son index. L'index de l'appareil audio utilis� par d�faut est 0.

-r <texte>
   Sp�cifie le p�riph�rique audio par son nom.

-c
   Utilise le texte du presse-papiers.

-t <ligne_de_texte>
   Utilise le texte de la ligne de commande. La ligne de commande peut contenir quelques options [-t].

-i
   Utilise le texte de flux d'entr�e standard (STDIN).

-o
   SAPI 4 : l�option n�est pas utilis�e.
   SAPI 5 et Microsoft Speech Platform : enregistre les donn�es audio dans le flux de sortie standard (STDOUT) ; si l'option est sp�cifi�e, l'option [-w] est ignor�e.

-s <nombre_int�gral>
   SAPI 4 : sp�cifie le d�bit de la parole compris entre 0 et 100 (pas de valeur par d�faut).
   SAPI 5 et Microsoft Speech Platform : sp�cifie le d�bit de la parole compris entre -10 et 10 (la valeur par d�faut est 0).

-p <nombre_int�gral>
   SAPI 4 : sp�cifie le timbre de la voix compris entre 0 et 100 (pas de valeur par d�faut).
   SAPI 5 et Microsoft Speech Platform : sp�cifie le timbre de la voix compris entre -10 et 10 (la valeur par d�faut est 0).

-v <nombre_int�gral>
   SAPI 4 : l�option n�est pas utilis�e.
   SAPI 5 et Microsoft Speech Platform : sp�cifie le volume compris entre 0 et 100 (la valeur par d�faut est 100).

-e <nombre_int�gral>
   Sp�cifie la longueur des pauses entre les phrases (en millisecondes). La valeur par d�faut est 0.

-a <nombre_int�gral>
   Sp�cifie la longueur des pauses entre les paragraphes (en millisecondes). La valeur par d�faut est 0.

-d <nom_de_fichier>
   Utilise un dictionnaire pour la correction de la prononciation (fichier *.BXD, *.DIC ou *.REX). La ligne de commande peut contenir quelques options [-d].

-k
   D�sactive les autres copies de l'application console dans la m�moire de l'ordinateur.

-ka
   D�sactiver la copie de l'application console en cours d'ex�cution.

-pr
   Make pause or resume reading aloud by the active copy of the application. The action is the same as for the context menu item "Pause"/"Resume".

-q
   Met l'application dans une file d'attente. L'application console va attendre que les autres copies du programme terminent leur op�ration.

-lrc
   SAPI 4 : l�option n�est pas utilis�e.
   SAPI 5 et Microsoft Speech Platform : cr�e un fichier LRC, si l'option [-w] ou [-o] est sp�cifi�e.

-srt
   SAPI 4 : l�option n�est pas utilis�e.
   SAPI 5 et Microsoft Speech Platform : cr�e un fichier SRT, si l'option [-w] ou [-o] est sp�cifi�e.

-vs <nom_de_fichier>
   SAPI 4 : l�option n�est pas utilis�e.
   SAPI 5 et Microsoft Speech Platform : sets the name of output text file with visemes, if the option [-w] is specified.
   A viseme is the mouth shape that corresponds to a particular speech sound. SAPI supports the list of 21 visemes.
   This list is based on the original Disney visemes. The application will create the audio file and then read it aloud to get visemes and their timecodes.
   The list of visemes supported by SAPI 5: https://msdn.microsoft.com/en-us/library/ms720881(v=vs.85).aspx

-sub
   Le texte constitue des sous-titres et doit �tre converti en fichier audio, compte tenu des pauses sp�cifi�es. Le param�tre peut �tre utile lorsque les options [-i] ou [-c] sont sp�cifi�es en ligne de commande.

-tray
   Afficher l'ic�ne du logiciel dans la zone de notification du syst�me d'exploitation.
   Cela permet � l'utilisateur de suivre l'ex�cution d'une op�ration et de l'arr�ter � l'aide de l'�l�ment ��Arr�t�� dans le menu contextuel.

-ln <nombre_int�gral>
   S�lectionner une ligne du fichier texte � l'aide de son num�ro. La num�rotation des lignes commence par "1".
   Pour s�lectionner plusieurs lignes, sp�cifiez les num�ros de la ligne de d�part et de celle d'ach�vement dans le texte (par exemple, "26�34").
   La ligne de commande peut contenir quelques options [-ln].

-fr <nombre_int�gral>
   SAPI 4 : l�option n�est pas utilis�e.
   SAPI 5 et Microsoft Speech Platform : sets the output audio sampling frequency in kHz (8, 11, 12, 16, 22, 24, 32, 44, 48).
   If the option is not specified, the default value of the selected voice will be used.

-bt <nombre_int�gral>
   SAPI 4 : l�option n�est pas utilis�e.
   SAPI 5 et Microsoft Speech Platform : sets the output audio bit depth (8 ou 16).
   If the option is not specified, the default value of the selected voice will be used.

-ch <nombre_int�gral>
   SAPI 4 : l�option n�est pas utilis�e.
   SAPI 5 et Microsoft Speech Platform : sets the output audio channel mode (1 ou 2).
   If the option is not specified, the default value of the selected voice will be used.

-? ou -h
   Affiche la liste des options de ligne de commande.

--encoding <encodage> ou -enc <encodage>
   L'encodage du texte de flux d'entr�e standard ("ansi", "utf8" ou "unicode"). La valeur par d�faut est "ansi".

--silence-begin <nombre_int�gral> ou -sb <nombre_int�gral>
   Sp�cifier la longueur de la pause en d�but du fichier audio (en millisecondes). La valeur par d�faut est 0.

--silence-end <nombre_int�gral> ou -se <nombre_int�gral>
   Sp�cifier la longueur de la pause en fin du fichier audio (en millisecondes). La valeur par d�faut est 0.

--lrc-length <nombre_int�gral>
   Sp�cifie la longueur maximale des lignes de texte pour le fichier LRC (en caract�res).

--lrc-fname <nom_de_fichier>
   Sp�cifie le nom du fichier LRC. L'option peut �tre utile lorsque l'option [-o] est sp�cifi�e en ligne de commande.

--lrc-enc <encodage>
   Sp�cifie l'encodage pour le fichier LRC ("ansi", "utf8" ou "unicode"). La valeur par d�faut est "ansi".

--lrc-offset <nombre_int�gral>
   Sp�cifie le d�calage temporel pour le fichier LRC (en millisecondes).

--lrc-artist <texte>
   Sp�cifie une balise ID pour le fichier LRC : artiste.

--lrc-album <texte>
   Sp�cifie une balise ID pour le fichier LRC : album.

--lrc-title <texte>
   Sp�cifie une balise ID pour le fichier LRC : titre.

--lrc-author <texte>
   Sp�cifie une balise ID pour le fichier LRC : auteur.

--lrc-creator <texte>
   Sp�cifie une balise ID pour le fichier LRC : cr�ateur du fichier LRC.

--lrc-sent
   Inserts blank lines after sentences in the LRC file.

--lrc-para
   Inserts blank lines after paragraphs in the LRC file.

--srt-length <nombre_int�gral>
   Sp�cifie la longueur maximale des lignes de texte pour le fichier SRT (en caract�res).

--srt-fname <nom_de_fichier>
   Sp�cifie le nom du fichier SRT. L'option peut �tre utile lorsque l'option [-o] est sp�cifi�e en ligne de commande.

--srt-enc <encodage>
   Sp�cifie l'encodage pour le fichier SRT ("ansi", "utf8" ou "unicode"). La valeur par d�faut est "ansi".

--raw
   SAPI 4 : l�option n�est pas utilis�e.
   SAPI 5 et Microsoft Speech Platform : sortie des donn�es audio comme fichiers PCM brut ; les donn�es audio sont sans l'en-t�te WAV.
   L'option est utilis�e avec l'option [-o].

--ignore-length ou -il
   SAPI 4 : l�option n�est pas utilis�e.
   SAPI 5 et Microsoft Speech Platform : omet la longueur des donn�es audio dans l'en-t�te WAV.
   L'option est utilis�e avec l'option [-o].

--sub-format <texte>
   Le format des sous-titres ("srt", "lrc", "ssa", "ass", "smi" ou "vtt"). Si le param�tre n'est pas sp�cifi�, le format est d�termin� d'apr�s l'extension du fichier des sous-titres.

--sub-fit ou -sf
   SAPI 4 : l�option n�est pas utilis�e.
   SAPI 5 et Microsoft Speech Platform : augmenter automatiquement le d�bit de la parole pour s'adapter aux intervalles sp�cifi�s dans les sous-titres.

--sub-max <nombre_int�gral> ou -sm <nombre_int�gral>
   SAPI 4 : l�option n�est pas utilis�e.
   SAPI 5 et Microsoft Speech Platform : sp�cifier le d�bit maximal de la parole dans une gamme de -10 � 10 (pour convertir des sous-titres en fichier audio).

--delete-file ou -df
   Supprimer le fichier texte apr�s la lecture � haute voix ou enregistrer le fichier audio.

--ignore-square-brackets ou -isb
   Ignore text in [square brackets].

--ignore-curly-brackets ou -icb
   Ignore text in {curly brackets}.

--ignore-angle-brackets ou -iab
   Ignore text in <angle brackets>.

--ignore-round-brackets ou -irb
   Ignore text in (round brackets).

--ignore-url ou -iu
   Ignore URLs.

--ignore-comments ou -ic
   Ignore comments in text. Single-line comments start with // and continue until the end of the line. Multiline comments start with /* and end with */.

--voice1-name <nom_de_voix>
   SAPI 4 : l�option n�est pas utilis�e.
   SAPI 5 et Microsoft Speech Platform : sets the additional voice name to read foreign words in text (the part of the name will be enough).
   The option is used together with the option [--voice1-langid]. Other voices can be set by options [--voice2-name], [--voice3-name], etc.

--voice1-langid <id_de_langue>
   Sets the language ID for foreign words in text. The option is used together with the option [--voice1-name]. The command line may contain more than one option [--voice1-langid]. Also an option may contain a comma-separated list of IDs.
   The list of supported language IDs is based on ISO 639-1 codes: am, ar, az, ba, bg, be, ca, cs, cu, cv, da, de, el, en, es, et, eu, fi, fil, fr, ja, he, hi, hr, hu, hy, it, gn, gu, ka, kk-Cyr, kk-Lat, kn, ko, ky, lo, lt, lv, mk, no, pl, pt, ro, ru, sk, sl, sr-Cyr, sr-Lat, sv, tg, th, tr, tt, uk, zh.

--voice1-rate <nombre_int�gral>
   Sets the rate for the additional voice in a range of -10 to 10 (the default is 0).

--voice1-pitch <nombre_int�gral>
   Sets the pitch for the additional voice in a range of -10 to 10 (the default is 0).

--voice1-volume <nombre_int�gral>
   Sets the volume for the additional voice in a range of 0 to 100 (the default is 100).

--voice1-roman
   Use the default voice to read Roman numerals in text. If text with non-Latin characters contains Roman numerals, the application will not change a voice to read them.

--voice1-digit
   Use the default voice to read numbers in text.

--voice1-length <nombre_int�gral>
   Set the minimal length of foreign text parts that will be read by the additional voice (in characters).


*** Exemples ***

balcon -l

balcon -n "Microsoft Anna" -m

balcon -f "d:\Text\book.txt" -w "d:\Sound\book.wav" -n "Emma"

balcon -n "Callie" -c -d "d:\rex\rules.rex" -d "d:\dic\rules.dic"

balcon -n "Mathieu" -t "Le texte sera lu lentement." -s -5 -v 70

balcon -k

balcon -f "d:\Text\book.txt" -w "d:\Sound\book.wav" -lrc --lrc-length 80 --lrc-title "The Lord of the Rings"

balcon -f "d:\Text\film.srt" -w "d:\Sound\film.wav" -n "Laura" --sub-fit --sub-max 2

balcon -f "d:\Text\book.txt" -n Kimberly --voice1-name Tatyana --voice1-langid ru


Un exemple de l'utilisation de l'application avec l'utilitaire LAME.EXE :

balcon -f d:\book.txt -n Julie -o --raw | lame -r -s 22.05 -m m -h - d:\book.mp3


Un exemple de l'utilisation de l'application avec l'utilitaire OGGENC2.EXE :

balcon -f d:\book.txt -n Julie -o -il | oggenc2 --ignorelength - -o d:\book.ogg


Un exemple de l'utilisation de l'application avec l'utilitaire WMAENCODE.EXE :

balcon -f d:\book.txt -n Julie -o -il | wmaencode - d:\book.wma --ignorelength


*** Fichier de configuration ***

Les options de ligne de commande peuvent �tre enregistr�es en tant que fichier de configuration � balcon.cfg � dans le m�me dossier que l'application console.

Exemple de fichier de configuration :
===============
-f d:\Text\book.txt
-w d:\Sound\book.wav
-n Microsoft Anna
-s 2
-p -1
-v 95
-e 300
-d d:\Dict\rules.bxd
-lrc
--lrc-length 75
--lrc-enc utf8
--lrc-offset 300
===============

Le programme peut combiner les options du fichier de configuration et celles de la ligne de commande.


*** Clips audio ***

Le logiciel permet d'ins�rer des liens vers des fichiers audio externes au format WAV (clips audio) dans le texte. La balise de clip audio ressemblera � ceci :

{{Audio=C:\Sounds\ring.wav}}

Si un lien vers un clip audio survient lors de la lecture d�un texte � haute voix, le logiciel se met en pause, lit le clip audio et ensuite reprend la parole.
Lors de la conversion de la parole en fichier audio, le clip audio externe sera int�gr� dans le fichier audio cr�� par le logiciel.


*** "Voice" Tag ***

S�il faut modifier une voix ou ses attributs, une balise sp�ciale peut �tre utilis�e pour SAPI 5 et Microsoft Speech Platform (les voix SAPI 4 ignoreront cette balise).

Format de la balise�:

{{Voice=Nom;Vitesse;Hauteur;Volume}}

- Nom � nom de la voix (un mot ou m�me une partie d�un mot suffit)�;
- Vitesse � vitesse de lecture (la valeur doit �tre entre -10 et 10) ;
- Hauteur � hauteur du son (la valeur doit �tre entre -10 et 10) ;
- Volume � volume du son (la valeur doit �tre entre 0 et 100).

La balise s�applique � tout le texte suivant. Les valeurs des attributs sont s�par�es au sein d�une m�me balise par des points-virgules. Par exemple�:

Le programme lira ce texte par la voix par d�faut. {{Voice=Audrey;0;0;100}} La voix Audrey lira le reste du texte.

Le contenu de la balise ne d�pend pas du registre des lettres. Les valeurs de certains attributs peuvent �tre omis�:

{{voice=mathieu;;;50}}

{{Voice=Thomas;-1}}

{{Voice=Suzanne}}

Pour retourner � la voix par d�faut choisie dans le programme, utilisez la balise ci-dessous�:

{{Voice=}}

Attention�! Il est impossible de basculer entre les voix SAPI 5 et les voix de Microsoft Speech Platform � l�aide des balises.


*** "Pause" Tag ***

Lorsque le programme convertit un texte en fichier audio, on peut utiliser une balise pour ins�rer une pause. La dur�e de la pause doit �tre sp�cifi�e en millisecondes.

Le silence durera deux secondes. {{Pause=2000}} Ensuite, la lecture reprendra.


*** Licence ***

Droits d'utilisation non commerciale de l�application :
- personnes physiques � sans restriction,
- personnes morales � avec les restrictions stipul�es dans l'Accord de Licence du logiciel Balabolka.

L�utilisation commerciale du logiciel demande l'autorisation du d�tenteur du copyright.

###
tools\readme.ger.txt
Balabolka (Konsolenanwendung), Version 1.78
Copyright (c) 2013-2021 Ilya Morozov
Alle Rechte vorbehalten

WWW: http://balabolka.site/de/bconsole.htm
E-mail: cro�[email protected] (nur ru�isch oder englisch)

Lizenzart: Freeware
Plattformen: Microsoft Windows XP/Vista/7/8/10
Microsoft Speech API: 4.0/5.0 und h�her
Microsoft Speech Platform: 11.0



*** Anwendung ***

balcon [Optionen ...]


*** Befehlszeilen-Optionen ***

-l
   Druckt die Liste der verf�gbaren Stimmen.

-g
   Druckt die Liste der verf�gbaren Audio-Ausgabeger�te.

-f <Dateiname>
   Bestimmt den Namen der Eingabe-Textdatei. Die Befehlszeile kann einige Optionen enthalten [-f].

-fl <Dateiname>
   Sets the name of the text file with the list of input files (one file name per line). Die Befehlszeile kann einige Optionen enthalten [-fl].

-w <Dateiname>
   Bestimmt den Namen der Ausgabe-Datei im WAV-Format. Wenn diese Option angegeben ist, wird eine Audio-Datei erstellt. Sonst wird der Text laut vorgelesen.

-n <Sprecher>
   Bestimmt den Namen des Sprechers (ein Teil des Namens ist ausreichend). 
   Wenn diese Option nicht festgelegt wurde, wird die Stimme, die durch die Option [-id] bestimmt wurde, oder die Standard-Stimme von Windows verwendet.

-id <Zahl>
   Setzt die "Lokale ID" f�r die Stimme. Die Lokale ID ist der von Microsoft zugewiesene Sprachen-Code
   (z. B. "1031" oder "0x0407" f�r "Deutsch - Deutschland", "1033" oder "0x0409" f�r "Englisch - Amerika").
   Das Programm wird die erste Stimme mit definierter Lokaler ID aus der Liste von Stimmen ausw�hlen. 
   Wenn diese Option nicht festgelegt wurde, wird die Stimme, die durch die Option [-n] bestimmt wurde, oder die Standard-Stimme von Windows verwendet.
   Liste der Sprachen mit zugewiesenen Codes: https://msdn.microsoft.com/en-us/library/cc233982.aspx

-m
   Druckt die Parameter der Stimme.

-b <Zahl>
   W�hlt das Audio-Ausgabeger�t nach seinem Index. Der Index des Standard-Audio-Ausgabeger�tes ist 0.

-r <Textzeile>
   W�hlt das Audio-Ausgabeger�t nach seinem Namen.

-c
   Verwendet die Texteingabe aus der Zwischenablage.

-t <Textzeile>
   Die Texteingabe kann von der Befehlszeile verwendet werden. Die Befehlszeile kann einige Optionen enthalten [-t].

-i
   Verwendet die Texteingabe von STDIN.

-o
   SAPI 4: nicht verwendet.
   SAPI 5 und Microsoft Speech Platform: Schreibt Tondaten auf STDOUT. Wenn diese Option gew�hlt ist, wird die Option [-w] ignoriert.

-s <Zahl>
   SAPI 4: Bestimmt die Geschwindigkeit in einem Bereich von 0 bis 100 (kein Standardwert).
   SAPI 5 und Microsoft Speech Platform: Bestimmt die Geschwindigkeit in einem Bereich von -10 bis 10 (der Standardwert ist 0).

-p <Zahl>
   SAPI 4: Bestimmt die Tonh�he in einem Bereich von 0 bis 100 (kein Standardwert).
   SAPI 5 und Microsoft Speech Platform: Bestimmt die Tonh�he in einem Bereich von -10 bis 10 (der Standardwert ist 0).

-v <Zahl>
   SAPI 4: nicht verwendet.
   SAPI 5 und Microsoft Speech Platform: Bestimmt das Volumen in einem Bereich von 0 bis 100 (der Standardwert ist 100).

-e <Zahl>
   Bestimmt die L�nge der Pausen zwischen den S�tzen (in Millisekunden). Der Standardwert ist 0.

-a <Zahl>
   Bestimmt die L�nge der Pausen zwischen den Abs�tzen (in Millisekunden). Der Standardwert ist 0.

-d <Dateiname>
   Verwendet das W�rterbuch f�r die Au�prache-Korrektur (*.BXD, *.DIC oder *.REX). Die Befehlszeile kann ein paar Optionen enthalten [-d].

-k
   Beendet weitere Exemplare der Konsolen-Anwendung im Arbeit�peicher des Computers.

-ka
   Beendet das aktive Exemplar der Konsolen-Anwendung im Arbeit�peicher des Computers.

-pr
   Macht eine Pause oder beginnt mit dem Lesen der aktiven Kopie der Anwendung. Die Aktion ist dieselbe wie f�r den Kontextmen�eintrag "Pause"/"Fortsetzen".

-q
   Setzt die Anwendung in eine Warteschlange. Die Konsolen-Anwendung wartet, bis andere Exemplare des Programms fertig sind.

-lrc
   SAPI 4: nicht verwendet.
   SAPI 5 und Microsoft Speech Platform: Erstellt eine LRC-Datei, wenn die Option [-w] oder [-o] angegeben ist.

-srt
   SAPI 4: nicht verwendet.
   SAPI 5 und Microsoft Speech Platform: Erstellt eine SRT-Datei, wenn die Option [-w] oder [-o] angegeben ist.

-vs <Dateiname>
   SAPI 4: nicht verwendet.
   SAPI 5 und Microsoft Speech Platform: Bestimmt den Namen der ausgegebenen Textdatei mit Visemen, wenn die Option [-w] angegeben ist.
   Ein Visem ist die Mundform, die einem bestimmten Sprachklang entspricht. SAPI unterst�tzt die Liste von 21 Visemen.
   Diese Liste basiert auf den originalen Disney Visemen. Die Anwendung erstellt die Audiodatei und liest sie dann laut, um Viseme und ihre Timecodes zu erhalten.
   Die Liste der von SAPI 5 unterst�tzten Viseme: https://msdn.microsoft.com/en-us/library/ms720881(v=vs.85).aspx

-sub
   Text wird als Untertitel verarbeitet. Diese Option kann n�tzlich sein, wenn die Optionen [-i] oder [-c] festgelegt wurden.

-tray
   Das Programm-Icon im System-Tray anzeigen. Dies erm�glicht es, den Fortschritt der Aufgabe zu sehen.
   Mit der Option "Stopp" im Kontext-Men� kann man den Proze� stoppen.

-ln <Zahl>
   W�hlt eine Zeile aus einer Textdatei mit Hilfe einer Zeilennummer. Die Zeilennummerierung beginnt bei "1".
   Ein Intervall von Zahlen kann verwendet werden, um mehr als eine Zeile auszuw�hlen (beispielsweise "26-34").
   Die Befehlszeile kann ein paar Optionen enthalten [-ln].

-fr <Zahl>
   SAPI 4: nicht verwendet.
   SAPI 5 und Microsoft Speech Platform: Legt die Ausgabe-Audio-Abtastfrequenz in kHz fest (8, 11, 12, 16, 22, 24, 32, 44, 48).
   Wenn die Option nicht angegeben ist, wird der Standardwert f�r die ausgew�hlte Stimme verwendet.

-bt <Zahl>
   SAPI 4: nicht verwendet.
   SAPI 5 und Microsoft Speech Platform: Legt die Audio-Bittiefe des Ausgangs (8 oder 16) fest.
   Wenn die Option nicht angegeben ist, wird der Standardwert f�r die ausgew�hlte Stimme verwendet.

-ch <Zahl>
   SAPI 4: nicht verwendet.
   SAPI 5 und Microsoft Speech Platform: Legt den Ausgabe-Audiokanal-Modus (1 oder 2) fest.
   Wenn die Option nicht angegeben ist, wird der Standardwert f�r die ausgew�hlte Stimme verwendet.

-? oder -h
   Druckt die Liste der verf�gbaren Befehlszeilen-Optionen.

--encoding <Kodierung> oder -enc <Kodierung>
   Bestimmt die Kodierung f�r die Texteingabe ("ansi", "utf8" oder "unicode"). Die Standardeinstellung ist "ansi".

--silence-begin <Zahl> oder -sb <Zahl>
   Legt die L�nge der Stille am Anfang der Audio-Datei fest (in Millisekunden). Der Standardwert ist 0.

--silence-end <Zahl> oder -se <Zahl>
   Legt die L�nge der Stille am Ende der Audio-Datei fest (in Millisekunden). Der Standardwert ist 0.

--lrc-length <Zahl>
   Bestimmt die maximale L�nge der Textzeilen f�r die LRC-Datei (in Zeichen).

--lrc-fname <Dateiname>
   Bestimmt den Namen der LRC-Datei. Die Option kann n�tzlich sein, wenn die Option [-o] angegeben ist.

--lrc-enc <Kodierung>
   Bestimmt die Kodierung f�r die LRC-Datei ("ansi", "utf8" oder "unicode"). Die Standardeinstellung ist "ansi".

--lrc-offset <Zahl>
   Bestimmt die Zeitverschiebung f�r die LRC-Datei (in Millisekunden).

--lrc-artist <Textzeile>
   Bestimmt den ID-Tag f�r die LRC-Datei: K�nstler.

--lrc-album <Textzeile>
   Bestimmt den ID-Tag f�r die LRC-Datei: Album.

--lrc-title <Textzeile>
   Bestimmt den ID-Tag f�r die LRC-Datei: Titel.

--lrc-author <Textzeile>
   Bestimmt den ID-Tag f�r die LRC-Datei: Autor.

--lrc-creator <Textzeile>
   Bestimmt den ID-Tag f�r die LRC-Datei: Ersteller der LRC-Datei.

--lrc-sent
   F�gt leere Zeilen nach S�tzen in die LRC-Datei ein.

--lrc-para
   F�gt leere Zeilen nach Abs�tzen in die LRC-Datei ein.

--srt-length <Zahl>
   Bestimmt die maximale L�nge der Textzeilen f�r die SRT-Datei (in Zeichen).

--srt-fname <Dateiname>
   Bestimmt den Namen der SRT-Datei. Die Option kann n�tzlich sein, wenn die Option [-o] angegeben ist.

--srt-enc <Kodierung>
   Bestimmt die Kodierung f�r die SRT-Datei ("ansi", "utf8" oder "unicode"). Die Standardeinstellung ist "ansi".

--raw
   SAPI 4: nicht verwendet.
   SAPI 5 und Microsoft Speech Platform: Der Ausgang ist RAW-Format PCM; die Audiodaten enthalten nicht den WAV-Header. Diese Option wird zusammen mit der Option [-o] verwendet.

--ignore-length oder -il
   SAPI 4: nicht verwendet.
   SAPI 5 und Microsoft Speech Platform: Ignoriert die L�nge der Daten im WAV-Header. Diese Option wird zusammen mit der Option [-o] verwendet.

--sub-format <Textzeile>
   Legt das Format der Untertitel fest ("srt", "lrc", "ssa", "ass", "smi" oder "vtt"). Wenn diese Option nicht angegeben ist, wird das Format anhand der Dateiendung bestimmt.

--sub-fit oder -sf
   SAPI 4: nicht verwendet.
   SAPI 5 und Microsoft Speech Platform: erh�ht die Geschwindigkeit automatisch, pa�end zu Zeitintervallen (wenn das Programm Untertitel in eine Audio-Datei konvertiert).

--sub-max <Zahl> oder -sm <Zahl>
   SAPI 4: nicht verwendet.
   SAPI 5 und Microsoft Speech Platform: legt die maximale Sprechgeschwindigkeit in einem Bereich von -10 bis 10 fest (wenn das Programm Untertitel in eine Audio-Datei konvertiert).

--delete-file oder -df
   Entfernt die Textdatei, wenn die Aufgabe erledigt ist. Diese Option wird zusammen mit der Option [-f] verwendet.

--ignore-square-brackets oder -isb
   Text in [eckigen Klammern] ignorieren.

--ignore-curly-brackets oder -icb
   Text in {geschweiften Klammern} ignorieren.

--ignore-angle-brackets oder -iab
   Text in <Winkelklammern> ignorieren.

--ignore-round-brackets oder -irb
   Text in (runden Klammern) ignorieren.

--ignore-url oder -iu
   URLs ignorieren.

--ignore-comments oder -ic
   Kommentare im Text ignorieren. Einzeilige Kommentare beginnen mit // und werden bis zum Ende der Zeile fortgesetzt. Mehrzeilige Kommentare beginnen mit /* und enden mit */.

--voice1-name <Sprecher>
   SAPI 4: nicht verwendet.
   SAPI 5 und Microsoft Speech Platform: sets the additional voice name to read foreign words in text (the part of the name will be enough).
   The option is used together with the option [--voice1-langid]. Other voices can be set by options [--voice2-name], [--voice3-name], etc.

--voice1-langid <Sprachen-ID>
   Sets the language ID for foreign words in text. The option is used together with the option [--voice1-name]. The command line may contain more than one option [--voice1-langid]. Also an option may contain a comma-separated list of IDs.
   The list of supported language IDs is based on ISO 639-1 codes: am, ar, az, ba, bg, be, ca, cs, cu, cv, da, de, el, en, es, et, eu, fi, fil, fr, ja, he, hi, hr, hu, hy, it, gn, gu, ka, kk-Cyr, kk-Lat, kn, ko, ky, lo, lt, lv, mk, no, pl, pt, ro, ru, sk, sl, sr-Cyr, sr-Lat, sv, tg, th, tr, tt, uk, zh.

--voice1-rate <Zahl>
   Sets the rate for the additional voice in a range of -10 to 10 (the default is 0).

--voice1-pitch <Zahl>
   Sets the pitch for the additional voice in a range of -10 to 10 (the default is 0).

--voice1-volume <Zahl>
   Sets the volume for the additional voice in a range of 0 to 100 (the default is 100).

--voice1-roman
   Use the default voice to read Roman numerals in text. If text with non-Latin characters contains Roman numerals, the application will not change a voice to read them.

--voice1-digit
   Use the default voice to read numbers in text.

--voice1-length <Zahl>
   Set the minimal length of foreign text parts that will be read by the additional voice (in characters).


*** Beispiele ***

balcon -l

balcon -n "Microsoft Anna" -m

balcon -f "d:\Text\book.txt" -w "d:\Sound\book.wav" -n "Emma"

balcon -n "Callie" -c -d "d:\rex\rules.rex" -d "d:\dic\rules.dic"

balcon -n "Matthias" -t "Der Text wird langsam vorgelesen." -s -5 -v 70

balcon -k

balcon -f "d:\Text\book.txt" -w "d:\Sound\book.wav" -lrc --lrc-length 80 --lrc-title "The Lord of the Rings"

balcon -f "d:\Text\film.srt" -w "d:\Sound\film.wav" -n "Laura" --sub-fit --sub-max 2

balcon -f "d:\Text\book.txt" -n Kimberly --voice1-name Tatyana --voice1-langid ru


Beispiel f�r die Verwendung zusammen mit LAME.EXE:

balcon -f d:\book.txt -n Klaus -o --raw | lame -r -s 22.05 -m m -h - d:\book.mp3


Beispiel f�r die Verwendung zusammen mit OGGENC2.EXE:

balcon -f d:\book.txt -n Klaus -o -il | oggenc2 --ignorelength - -o d:\book.ogg


Beispiel f�r die Verwendung zusammen mit WMAENCODE.EXE:

balcon -f d:\book.txt -n Klaus -o -il | wmaencode - d:\book.wma --ignorelength


*** Konfigurationsdatei ***

Die Befehlszeilen-Optionen k�nnen als Konfigurationsdatei "balcon.cfg" im Ordner der Konsolen-Anwendung gespeichert werden. 

Beispiel f�r eine Konfigurationsdatei:
===============
-f d:\Text\book.txt
-w d:\Sound\book.wav
-n Microsoft Anna
-s 2
-p -1
-v 95
-e 300
-d d:\Dict\rules.bxd
-lrc
--lrc-length 75
--lrc-enc utf8
--lrc-offset 300
===============

Das Programm kann Optionen von der Konfigurationsdatei und der Kommandozeile kombinieren.


*** Audio-Clips ***

Das Programm erm�glicht, Links zu externen WAV- und MP3-Dateien (Audio-Clips) in Text von Dokumenten einzuf�gen. Ein Audio-Clip-Tag wird so au�ehen:

{{Audio=C:\Sounds\ring.wav}}

Beim Vorlesen von Text wird Balabolka unterbrochen, wenn das Audio-Clip-Tag erreicht ist, der Audio-Clip wird gespielt und das Vorlesen wird fortgesetzt.
Bei der Umwandlung in Audio-Dateien wird der Audio-Clip in der Audio-Datei, die durch das Programm erstellt wird, eingebettet werden.


*** Voice ***

Wenn eine Stimme oder ihre Eigenschaften beim Vorlesen ge�ndert werden m��en, kann f�r SAPI 5 und Microsoft Speech Platform ein spezielles Tag verwendet werden (SAPI4-Stimmen ignorieren dieses Tag).

Das Tag-Format:

{{Voice=Name;Geschwindigkeit;Tonh�he;Lautst�rke}}

- Name: der Name einer Stimme (ein Wort oder ein Teil eines Wortes ist ausreichend);
- Geschwindigkeit: die Geschwindigkeit einer Stimme (Werte von -10 bis 10);
- Tonh�he: die Tonh�he einer Stimme (Werte von -10 bis 10);
- Lautst�rke: die Lautst�rke (Werte von 0 bis 100).

Ein Tag gilt f�r alle nachfolgenden Texte. Die Werte werden durch Semikolon getrennt. Beispielsweise:

Dieser Text wird von der Standardstimme von Balabolka gesprochen. {{Voice=Marlene;0;0;100}} Die Stimme 'Marlene' liest den anderen Text.

Der Inhalt des Tags unterscheidet nicht zwischen Gro�- und Kleinschreibung. Werte f�r einige Eigenschaften k�nnen weggela�en werden:

{{voice=victor;;;50}}

{{Voice=Hans;-1}}

{{Voice=Petra}}

Verwenden Sie dieses Tag, um zur Standardstimme zur�ckzukehren:

{{Voice=}}

Warnung! Es ist nicht m�glich, zwischen SAPI 5-Stimmen und Stimmen der Microsoft Speech Platform zu wechseln.


*** Pause ***

Eine festgelegte Anzahl von Millisekunden Stille kann in die Ausgabe-Audiodatei eingef�gt werden. Beispielsweise:

Einhundertzwanzig Millisekunden Stille {{Pause=120}} sind gerade eingetreten.


*** Lizenzart ***

Sie k�nnen Software f�r nichtkommerzielle Zwecke verwenden und vertreiben. F�r die kommerzielle Nutzung oder den Vertrieb ben�tigen Sie die Genehmigung des Urheberrechtsinhabers.

###
tools\readme.pol.txt
Balabolka (aplikacja konsolowa), wersja 1.78
Copyright (c) 2013-2021 Ilya Morozov
Wszystkie prawa zastrze�one

WWW: http://balabolka.site/pl/bconsole.htm
E-mail: [email protected]

Licenzja: Freeware
System operacyjny: Microsoft Windows XP/Vista/7/8/10
Microsoft Speech API: 4.0/5.0
Microsoft Speech Platform: 11.0



*** Wiersz polece� ***

balcon [parametry ...]


*** Parametry wiersza polece� ***

-l
   Pokaza� list� g�os�w zainstalowanych na komputerze.

-g
   Pokaza� list� dost�pnych urz�dze� audio.

-f <nazwa_pliku>
   Otworzy� plik tekstowy. Wiersz polece� mo�e zawiera� kilka parametr�w [-f].

-fl <nazwa_pliku>
   Sets the name of the text file with the list of input files (one file name per line). Wiersz polece� mo�e zawiera� kilka parametr�w [-fl].

-w <nazwa_pliku>
   Zapisa� plik d�wi�kowy w formacie WAV. Je�li parametr jest ustawiony, plik d�wi�kowy zostanie utworzony. Je�li parametr nie jest ustawiony, tekst zostanie przeczytany na g�os.

-n <nazwa_g�osu>
   Wybra� g�os (wystarczy poda� cz�� jego nazwy). Je�li parametr nie jest ustawiony, b�dzie u�ywany g�os wybrany w Panelu sterowania systemu Windows.

-id <liczba>
   Wybra� g�os komputerowy za pomoc� identyfikatora j�zyka (Locale ID). Takie identyfikatory s� przypisane wszystkim j�zykom przez programist�w Microsoft
   (np. "1045" lub "0x0415" - j�zyk polski, "1058" lub "0x0422" - j�zyk ukrai�ski).
   Program wybierze z listy pierwszy g�os, identyfikator kt�rego odpowiada okre�lonej warto�ci.
   Je�li ten parametr nie zostanie okre�lony, b�dzie u�ywany g�os okre�lony przez parametr [-n] lub wybrany w Panelu sterowania systemu Windows.
   Lista identyfikator�w: https://msdn.microsoft.com/en-us/library/cc233982.aspx

-m
   Pokaza� parametry wybranego g�osu.

-b <liczba>
   Wybra� urz�dzenie audio przez jego numer na li�cie dost�pnych urz�dze� do odtwarzania d�wi�ku. Numer urz�dzenia domy�lnego dor�wna 0.

-r <tekst>
   Sets the audio output device by its name.

-c
   U�y� tekstu ze schowka.

-t <tekst>
   U�y� tekstu z wiersza polece�. Wiersz polece� mo�e zawiera� kilka parametr�w [-t].

-i
   U�y� tekstu z standarowego strumienia wej�cia (STDIN).

-o
   SAPI 4: parametr nie jest u�ywany.
   SAPI 5 i Microsoft Speech Platform: zapisa� d�wi�k do standarowego strumienia wyj�cia (STDOUT); je�li parametr jest ustawiony, parametr [-w] jest ignorowany.

-s <liczba>
   SAPI 4: ustawi� pr�dko�� mowy w zakresie od 0 do 100 (brak warto�ci domy�lnych).
   SAPI 5 i Microsoft Speech Platform: ustawi� pr�dko�� mowy w zakresie od -10 do 10 (warto�� domy�lna dor�wna 0).

-p <liczba>
   SAPI 4: ustawi� ton mowy w zakresie od 0 do 100 (brak warto�ci domy�lnych).
   SAPI 5 i Microsoft Speech Platform: ustawi� ton mowy w zakresie od -10 do 10 (warto�� domy�lna dor�wna 0).

-v <liczba>
   SAPI 4: parametr nie jest u�ywany.
   SAPI 5 i Microsoft Speech Platform: ustawi� g�osno�� mowy w zakresie od 0 do 100 (warto�� domy�lna dor�wna 100).

-e <liczba>
   Ustawi� d�ugo�� pauzy mi�dzy zdaniami (milisekundy). Warto�� domy�lna dor�wna 0.

-a <liczba>
   Ustawi� d�ugo�� pauzy mi�dzy akapitami (milisekundy). Warto�� domy�lna dor�wna 0.

-d <nazwa_pliku>
   U�y� s�ownika do korekty wymowy (plik z rozszerzeniem *.BXD, *.DIC lub *.REX). Wiersz polece� mo�e zawiera� kilka parametr�w [-d].

-k
   Zatrzyma� prace innych egzemplarzy aplikacji konsolowej uruchomionych na komputerze.

-ka
   Kills the active copy of the console application in the computer's memory.

-pr
   Make pause or resume reading aloud by the active copy of the application. The action is the same as for the context menu item "Pause"/"Resume".

-q
   Doda� aplikacj� do kolejki. Aplikacja konsolowa b�dzie czeka�, a� inne egzemplarzy programu sko�cz� prac�.

-lrc
   SAPI 4: parametr nie jest u�ywany.
   SAPI 5 i Microsoft Speech Platform: utworzy� plik LRC, je�li ustawione parametry [-w] lub [-o].

-srt
   SAPI 4: parametr nie jest u�ywany.
   SAPI 5 i Microsoft Speech Platform: utworzy� plik SRT, je�li ustawione parametry [-w] lub [-o].

-vs <nazwa_pliku>
   SAPI 4: parametr nie jest u�ywany.
   SAPI 5 i Microsoft Speech Platform: sets the name of output text file with visemes, if the option [-w] is specified.
   A viseme is the mouth shape that corresponds to a particular speech sound. SAPI supports the list of 21 visemes.
   This list is based on the original Disney visemes. The application will create the audio file and then read it aloud to get visemes and their timecodes.
   The list of visemes supported by SAPI 5: https://msdn.microsoft.com/en-us/library/ms720881(v=vs.85).aspx

-sub
   Tekst wygl�da jak napisy do plik�w i musi by� przekszta�cony w plik d�wi�kowy z wrachowaniem okre�lonych odst�p�w czasu.

-tray
   Pokaza� ikon� programu w obszarze powiadomie� systemu operacyjnego.
   To pozwoli u�ytkownikowi monitorowa� post�p operacji, oraz przerwa� proces klikaj�c "Stop" w menu kontekstowym.

-ln <liczba>
   Selects a line from the text file by using of a line number. The line numbering starts at "1".
   The interval of numbers can be used for selecting of more than one line (for example, "26-34").
   Wiersz polece� mo�e zawiera� kilka parametr�w [-ln].

-fr <liczba>
   SAPI 4: parametr nie jest u�ywany.
   SAPI 5 i Microsoft Speech Platform: sets the output audio sampling frequency in kHz (8, 11, 12, 16, 22, 24, 32, 44, 48).
   If the option is not specified, the default value of the selected voice will be used.

-bt <liczba>
   SAPI 4: parametr nie jest u�ywany.
   SAPI 5 i Microsoft Speech Platform: sets the output audio bit depth (8 lub 16).
   If the option is not specified, the default value of the selected voice will be used.

-ch <liczba>
   SAPI 4: parametr nie jest u�ywany.
   SAPI 5 i Microsoft Speech Platform: sets the output audio channel mode (1 lub 2).
   If the option is not specified, the default value of the selected voice will be used.

-? lub -h
   Pokaza� opis parametr�w wiersza polece�.

--encoding <kodowanie> lub -enc <kodowanie>
   Kodowanie tekstu ze standardowego strumiena wej�ciowego ("ansi", "utf8" lub "unicode"). Warto�� domy�lna dor�wna "ansi".

--silence-begin <liczba> lub -sb <liczba>
   Ustawi� d�ugo�� pauzy na pocz�tku pliku d�wi�kowego (w milisekundach). Warto�� domy�lna dor�wna 0.

--silence-end <liczba> lub -se <liczba>
   Ustawi� d�ugo�� pauzy na ko�cu pliku d�wi�kowego (w milisekundach). Warto�� domy�lna dor�wna 0.

--lrc-length <liczba>
   Ustawi� maksymaln� d�ugo�� wierszy plika LRC (symboli).

--lrc-fname <nazwa_pliku>
   Nazwa pliku LRC. Parametr mo�e by� przydatny gdy w wierszu polece� ustawiony parametr [-o].

--lrc-enc <kodowanie>
   Kodowanie pliku LRC ("ansi", "utf8" lub "unicode"). Warto�� domy�lna dor�wna "ansi".

--lrc-offset <liczba>
   Ustawi� przesuni�cie czasu dla pliku LRC (milisekundy).

--lrc-artist <tekst>
   Znacznik dla pliku LRC: wykonawca utworu.

--lrc-album <tekst>
   Znacznik dla pliku LRC: album.

--lrc-title <tekst>
   Znacznik dla pliku LRC: nazwa utworu.

--lrc-author <tekst>
   Znacznik dla pliku LRC: autor.

--lrc-creator <tekst>
   Znacznik dla pliku LRC: tw�rc� pliku.

--lrc-sent
   Inserts blank lines after sentences in the LRC file.

--lrc-para
   Inserts blank lines after paragraphs in the LRC file.

--srt-length <liczba>
   Ustawi� maksymaln� d�ugo�� wierszy plika SRT (symboli).

--srt-fname <nazwa_pliku>
   Nazwa pliku SRT. Parametr mo�e by� przydatny gdy w wierszu polece� ustawiony parametr [-o].

--srt-enc <kodowanie>
   Kodowanie pliku SRT ("ansi", "utf8" lub "unicode"). Warto�� domy�lna dor�wna "ansi".

--raw
   SAPI 4: parametr nie jest u�ywany.
   SAPI 5 i Microsoft Speech Platform: zapisa� d�wiek w formacie RAW PCM; dane nie zawieraj� tytu�u formatu WAV.
   Parametr wykorzystuj� si� razem z parametrem [-o].

--ignore-length lub -il
   SAPI 4: parametr nie jest u�ywany.
   SAPI 5 i Microsoft Speech Platform: nie zapisywa� rozmiar audio do tytu�u formatu WAV. Parametr wykorzystuj� si� razem z parametrem [-o].

--sub-format <tekst>
   Format napis�w filmowych ("srt", "lrc", "ssa", "ass", "smi" lub "vtt"). Je�li parametr nie okre�lony format zostanie wybrany przez rozszerzenie nazwy pliku napis�w.

--sub-fit lub -sf
   SAPI 4: parametr nie jest u�ywany.
   SAPI 5 i Microsoft Speech Platform: automatycznie zwi�ksza� pr�dko�� mowy aby zmie�ci� si� w odst�py czasu okre�lone w napisach.

--sub-max <liczba> lub -sm <liczba>
   SAPI 4: parametr nie jest u�ywany.
   SAPI 5 i Microsoft Speech Platform: ustawi� maksymaln� pr�dko�� mowy w zakresie od -10 do 10 (do konwersji napis�w w pliki d�wi�kowe).

--delete-file lub -df
   Usun�� plik tekstowy po zako�czeniu czytania na g�os lub zapisywania pliku d�wi�kowego.

--ignore-square-brackets lub -isb
   Ignore text in [square brackets].

--ignore-curly-brackets lub -icb
   Ignore text in {curly brackets}.

--ignore-angle-brackets lub -iab
   Ignore text in <angle brackets>.

--ignore-round-brackets lub -irb
   Ignore text in (round brackets).

--ignore-url lub -iu
   Ignore URLs.

--ignore-comments lub -ic
   Ignore comments in text. Single-line comments start with // and continue until the end of the line. Multiline comments start with /* and end with */.

--voice1-name <nazwa_g�osu>
   SAPI 4: parametr nie jest u�ywany.
   SAPI 5 i Microsoft Speech Platform: sets the additional voice name to read foreign words in text (the part of the name will be enough).
   The option is used together with the option [--voice1-langid]. Other voices can be set by options [--voice2-name], [--voice3-name], etc.

--voice1-langid <identyfikator_j�zyka>
   Sets the language ID for foreign words in text. The option is used together with the option [--voice1-name]. The command line may contain more than one option [--voice1-langid]. Also an option may contain a comma-separated list of IDs.
   The list of supported language IDs is based on ISO 639-1 codes: am, ar, az, ba, bg, be, ca, cs, cu, cv, da, de, el, en, es, et, eu, fi, fil, fr, ja, he, hi, hr, hu, hy, it, gn, gu, ka, kk-Cyr, kk-Lat, kn, ko, ky, lo, lt, lv, mk, no, pl, pt, ro, ru, sk, sl, sr-Cyr, sr-Lat, sv, tg, th, tr, tt, uk, zh.

--voice1-rate <liczba>
   Sets the rate for the additional voice in a range of -10 to 10 (the default is 0).

--voice1-pitch <liczba>
   Sets the pitch for the additional voice in a range of -10 to 10 (the default is 0).

--voice1-volume <liczba>
   Sets the volume for the additional voice in a range of 0 to 100 (the default is 100).

--voice1-roman
   Use the default voice to read Roman numerals in text. If text with non-Latin characters contains Roman numerals, the application will not change a voice to read them.

--voice1-digit
   Use the default voice to read numbers in text.

--voice1-length <liczba>
   Set the minimal length of foreign text parts that will be read by the additional voice (in characters).


*** Przyk�ady ***

balcon -l

balcon -n "Microsoft Anna" -m

balcon -f "d:\Text\book.txt" -w "d:\Sound\book.wav" -n "Emma"

balcon -n "Callie" -c -d "d:\rex\rules.rex" -d "d:\dic\rules.dic"

balcon -n "Ewa" -t "Tekst b�dzie czytany wolno." -s -5 -v 70

balcon -k

balcon -f "d:\Text\book.txt" -w "d:\Sound\book.wav" -lrc --lrc-length 80 --lrc-title "The Lord of the Rings"

balcon -f "d:\Text\film.srt" -w "d:\Sound\film.wav" -n "Laura" --sub-fit --sub-max 2

balcon -f "d:\Text\book.txt" -n Kimberly --voice1-name Tatyana --voice1-langid ru


Przyk�ad wykorzystania aplikacji razem z oprogramowaniem narz�dziowym LAME.EXE:

balcon -f d:\book.txt -n Heather -o --raw | lame -r -s 22.05 -m m -h - d:\book.mp3


Przyk�ad wykorzystania aplikacji razem z oprogramowaniem narz�dziowym OGGENC2.EXE:

balcon -f d:\book.txt -n Heather -o -il | oggenc2 --ignorelength - -o d:\book.ogg


Przyk�ad wykorzystania aplikacji razem z oprogramowaniem narz�dziowym WMAENCODE.EXE:

balcon -f d:\book.txt -n Heather -o -il | wmaencode - d:\book.wma --ignorelength


*** Plik konfiguracyjny ***

Parametry mo�na zachowa� jak plik konfiguracyjny "balcon.cfg" w tym samym folderze co aplikacja konsolowa.

Przyk�ad zawarto�ci pliku:
===============
-f d:\Text\book.txt
-w d:\Sound\book.wav
-n Microsoft Anna
-s 2
-p -1
-v 95
-e 300
-d d:\Dict\rules.bxd
-lrc
--lrc-length 75
--lrc-enc utf8
--lrc-offset 300
===============

Program mo�e kombinowa� parametry z pliku konfiguracyjnego i wiersza polece�.


*** Audio Clips ***

The application allows to insert links to external WAV files (audio clips) into text. Audio clip tag will look like:

{{Audio=C:\Sounds\ring.wav}}

When speaking text aloud, the program will pause when the audio clip tag is reached, play the audio clip and resume speaking.
When converting to audio files, the audio clip will be embedded in the audio file created by the application.


*** "Voice" Tag ***

If it is necessary to change a voice or its properties during reading aloud, a special tag can be used for SAPI 5 and Microsoft Speech Platform (SAPI 4 voices will ignore this tag).

The tag format:

{{Voice=Name;Rate;Pitch;Volume}}

- Name: the name of a voice (one word or the part of a word is enough);
- Rate: the rate of a voice (values range from -10 to 10);
- Pitch: the pitch of a voice (values range from -10 to 10);
- Volume: the volume (values range from 0 to 100).

A tag applies to all subsequent text. The values are separated by semicolons. For example:

This text will be spoken by the default voice of Balabolka. {{Voice=Kimberly;0;0;100}} The voice 'Kimberly' will read the other text.

The tag's content is case insensitive. Values for some properties can be omitted:

{{voice=eric;;;50}}

{{Voice=Hans;-1}}

{{Voice=Rachel}}

To return to the default voice, use this tag:

{{Voice=}}

Warning! It is impossible to switch between SAPI 5 voices and voices of the Microsoft Speech Platform.


*** "Pause" Tag ***

A specified number of milliseconds of silence can be inserted into the output audio file. For example:

One hundred twenty milliseconds of silence {{Pause=120}} just occurred.


*** Licencja ***

Prawo do u�ytku niekomercyjnego: 
- dla os�b fizycznych - bez ogranicze�;
- dla os�b prawnych - z zastrze�eniem ogranicze�, co okre�la "Umowa licencyjna" programu Balabolka.

U�ytek komercyjny dozwolony jedynie za wcze�niejsz� zgod� posiadacza praw autorskich.

###
tools\readme.por.txt
Balabolka (aplicativo de console), vers�o 1.78
Copyright (c) 2013-2021 Ilya Morozov
All Rights Reserved

WWW: http://balabolka.site/br/bconsole.htm
E-mail: [email protected]

Licen�a: Freeware
Sistema operacional: Microsoft Windows XP/Vista/7/8/10
Microsoft Speech API: 4.0/5.0
Microsoft Speech Platform: 11.0



*** Linha de comando ***

balcon [op��es ...]


*** Op��es de comando ***

-l
   Mostrar a lista das vozes instaladas no seu computador.

-g
   Mostrar a lista dos dispositivos de �udio dispon�veis.

-f <nome_do_arquivo>
   Abrir o arquivo de texto. A linha de comando pode conter v�rias op��es [-f].

-fl <nome_do_arquivo>
   Sets the name of the text file with the list of input files (one file name per line). A linha de comando pode conter v�rias op��es [-fl].

-w <nome_do_arquivo>
   Gravar um arquivo de �udio em formato WAV. Especificando a op��o, ser� criado o arquivo de �udio. Se a op��o n�o � especificada, o texto ser� lido em voz alta.

-n <nome_da_voz>
   Nome de voz (basta digitar uma parte do nome). No caso de n�o ser especificada, ser� usada a voz selecionada no painel de controlo do Windows.

-id <n�mero>
   Selecione a voz artificial usando o identificador de l�ngua (Locale ID). Esses identificadores est�o atribu�dos a todas as l�nguas pelos desenvolvedores da Microsoft
   (por exemplo, "1033" ou "0x0409" para ingl�s, "1046" ou "0x0416" para o portugu�s brasileiro).
   O programa vai selecionar a partir de uma lista a primeira voz, cujo identificador de l�ngua corresponde a um valor especificado.
   Se a op��o n�o for especificada, ser� usada a voz indicada pelo par�metro [-n], ou a voz selecionada no Painel de Controlo do Windows.
   Lista de identificadores: https://msdn.microsoft.com/en-us/library/cc233982.aspx

-m
   Mostrar par�metros para a voz selecionada.

-b <n�mero>
   Escolher o dispositivo de �udio segundo o n�mero na lista de dispositivos dispon�veis para reprodu��o de �udio. O n�mero padr�o do dispositivo � 0.

-r <texto>
   Sets the audio output device by its name.

-c
   Usar o texto a partir da �rea de transfer�ncia.

-t <linha_de_texto>
   Usar o texto a partir da linha de comando. A linha de comando pode conter v�rias op��es [-t].

-i
   Usar o texto a partir do fluxo de entrada padr�o (STDIN).

-o
   SAPI 4: a op��o n�o � usada.
   SAPI 5 e Microsoft Speech Platform: gravar dados de �udio para o fluxo de sa�da padr�o (STDOUT); em caso de ser especificado, a op��o [-w] � ignorada.

-s <n�mero>
   SAPI 4: configurar a velocidade de fala na faixa de 0 a 100 (sem padr�o).
   SAPI 5 e Microsoft Speech Platform: configurar velocidade de fala na faixa de -10 a 10 (o padr�o � 0).

-p <n�mero>
   SAPI 4: ajustar o tom da voz, na faixa de 0 a 100 (sem padr�o).
   SAPI 5 e Microsoft Speech Platform: definir o tom de voz na faixa de -10 a 10 (o padr�o � 0).

-v <n�mero>
   SAPI 4: a op��o n�o � usada.
   SAPI 5 e Microsoft Speech Platform: definir o volume na faixa de 0 a 100 (o padr�o � 100).

-e <n�mero>
   Ajustar o comprimento das pausas entre as frases (em milissegundos). O padr�o � 0.

-a <n�mero>
   Ajustar o comprimento das pausas entre os par�grafos (em milissegundos). O padr�o � 0.

-d <nome_do_arquivo>
   Use o dicion�rio para a pron�ncia correcta (arquivo com nextens�o *.BXD, *.DIC ou *.REX). A linha de comando pode conter v�rias op��es [-d].

-k
   Parar o funcionamento de outras c�pias do aplicativo de console em execu��o no computador.

-ka
   Parar o funcionamento de um aplicativo de console que est� activo no momento.

-pr
   Make pause or resume reading aloud by the active copy of the application. The action is the same as for the context menu item "Pause"/"Resume".

-q
   Adicionar o aplicativo para a fila. O aplicativo de console vai esperar at� que as outras c�pias do programa terminem de funcionar.

-lrc
   SAPI 4: a op��o n�o � usada.
   SAPI 5 e Microsoft Speech Platform: criar um ficheiro do formato LRC, estando especificados os par�metros [-w] ou [-o].

-srt
   SAPI 4: a op��o n�o � usada.
   SAPI 5 e Microsoft Speech Platform: criar um ficheiro do formato SRT, estando especificados os par�metros [-w] ou [-o].

-vs <nome_do_arquivo>
   SAPI 4: a op��o n�o � usada.
   SAPI 5 e Microsoft Speech Platform: sets the name of output text file with visemes, if the option [-w] is specified.
   A viseme is the mouth shape that corresponds to a particular speech sound. SAPI supports the list of 21 visemes.
   This list is based on the original Disney visemes. The application will create the audio file and then read it aloud to get visemes and their timecodes.
   The list of visemes supported by SAPI 5: https://msdn.microsoft.com/en-us/library/ms720881(v=vs.85).aspx

-sub
   O texto representa subt�tulos e deve ser convertido em um ficheiro �udio com os intervalos de tempo especificados.

-tray
   Mostrar o �cone do programa na �rea de notifica��o do sistema operacional.
   Isso permite que o usu�rio monitore o progresso da opera��o, bem como interromper o processo no menu de contexto, clicando em "Stop".

-ln <n�mero>
   Selects a line from the text file by using of a line number. The line numbering starts at "1".
   The interval of numbers can be used for selecting of more than one line (for example, "26-34").
   A linha de comando pode conter v�rias op��es [-ln].

-fr <n�mero>
   SAPI 4: a op��o n�o � usada.
   SAPI 5 e Microsoft Speech Platform: sets the output audio sampling frequency in kHz (8, 11, 12, 16, 22, 24, 32, 44, 48).
   If the option is not specified, the default value of the selected voice will be used.

-bt <n�mero>
   SAPI 4: a op��o n�o � usada.
   SAPI 5 e Microsoft Speech Platform: sets the output audio bit depth (8 ou 16).
   If the option is not specified, the default value of the selected voice will be used.

-ch <n�mero>
   SAPI 4: a op��o n�o � usada.
   SAPI 5 e Microsoft Speech Platform: sets the output audio channel mode (1 ou 2).
   If the option is not specified, the default value of the selected voice will be used.

-? ou -h
   Mostrar a descri��o das op��es da linha de comando.

--encoding <codifica��o> ou -enc <codifica��o>
   Codifica��o de texto a partir da entrada padr�o ("ansi", "utf8" ou "unicode"). O valor padr�o � "ansi".

--silence-begin <n�mero> ou -sb <n�mero>
   Especificar a dura��o da pausa no in�cio do ficheiro �udio (em milissegundos). O padr�o � 0.

--silence-end <n�mero> ou -se <n�mero>
   Especificar a dura��o da pausa no final de um ficheiro �udio (em milissegundos). O padr�o � 0.

--lrc-length <n�mero>
   Especificar o comprimento m�ximo de cordas para ficheiro de formato LRC (em caracteres).

--lrc-fname <nome_do_arquivo>
   Nome  de ficheiro  do formato  LRC. A op��o pode ser �til em casos em que a linha de comando estiver definido o par�metro [-o].

--lrc-enc <codifica��o>
   Codifica��o de ficheiro do formato LRC ("ansi", "utf8" ou "unicode"). O valor padr�o � "ansi".

--lrc-offset <n�mero>
   Especificar a mudan�a da hora no ficheiro do formato LRC (em milissegundos).

--lrc-artist <texto>
   Etiqueta para ficheiro do formato LRC: int�rprete da obra.

--lrc-album <texto>
   Etiqueta para ficheiro do formato LRC: �lbum.

--lrc-title <texto>
   Etiqueta para ficheiro do formato LRC: t�tulo da obra.

--lrc-author <texto>
   Etiqueta para ficheiro do formato LRC: autor.

--lrc-creator <texto>
   Etiqueta para ficheiro do formato LRC: criador do ficheiro.

--lrc-sent
   Inserts blank lines after sentences in the LRC file.

--lrc-para
   Inserts blank lines after paragraphs in the LRC file.

--srt-length <n�mero>
   Especificar o comprimento m�ximo de cordas para ficheiro de formato SRT (em caracteres).

--srt-fname <nome_do_arquivo>
   Nome  de ficheiro  do formato SRT. A op��o pode ser �til em casos em que a linha de comando estiver definido o par�metro [-o].

--srt-enc <codifica��o>
   Codifica��o de ficheiro do formato SRT ("ansi", "utf8" ou "unicode"). O valor padr�o � "ansi".

--raw
   SAPI 4: a op��o n�o � usada.
   SAPI 5 e Microsoft Speech Platform: gravar �udio no formato PCM RAW;  os dados n�o cont�m t�tulo do formato WAV. Esta op��o � utilizada em conjunto com [-o].

--ignore-length ou -il
   SAPI 4: a op��o n�o � usada.
   SAPI 5 e Microsoft Speech Platform: n�o inscrever o tamanho dos dados de �udio no t�tulo do formato WAV. Esta op��o � utilizada em conjunto com [-o].

--sub-format <texto>
   Formato  dos subt�tulos ("srt", "lrc", "ssa", "ass", "smi" ou "vtt"). Se n�o for especificado, o formato ser� determinado pela extens�o do nome do ficheiro de subt�tulos.

--sub-fit ou -sf
   SAPI 4: a op��o n�o � usada.
   SAPI 5 e Microsoft Speech Platform: aumentar automaticamente a velocidade da fala, a fim de conseguir cumprir os intervalos definidos nos subt�tulos.

--sub-max <n�mero> ou -sm <n�mero>
   SAPI 4: a op��o n�o � usada.
   SAPI 5 e Microsoft Speech Platform: especificar a velocidade m�xima de fala na faixa de -10 a 10 (para converter subt�tulos em ficheiros de �udio).

--delete-file ou -df
   Eliminar um ficheiro de texto depois de ler em voz alta ou salvar o ficheiro de �udio.

--ignore-square-brackets ou -isb
   Ignore text in [square brackets].

--ignore-curly-brackets ou -icb
   Ignore text in {curly brackets}.

--ignore-angle-brackets ou -iab
   Ignore text in <angle brackets>.

--ignore-round-brackets ou -irb
   Ignore text in (round brackets).

--ignore-url ou -iu
   Ignore URLs.

--ignore-comments ou -ic
   Ignore comments in text. Single-line comments start with // and continue until the end of the line. Multiline comments start with /* and end with */.

--voice1-name <nome_da_voz>
   SAPI 4: a op��o n�o � usada.
   SAPI 5 e Microsoft Speech Platform: sets the additional voice name to read foreign words in text (the part of the name will be enough).
   The option is used together with the option [--voice1-langid]. Other voices can be set by options [--voice2-name], [--voice3-name], etc.

--voice1-langid <ID_do_idioma>
   Sets the language ID for foreign words in text. The option is used together with the option [--voice1-name]. The command line may contain more than one option [--voice1-langid]. Also an option may contain a comma-separated list of IDs.
   The list of supported language IDs is based on ISO 639-1 codes: am, ar, az, ba, bg, be, ca, cs, cu, cv, da, de, el, en, es, et, eu, fi, fil, fr, ja, he, hi, hr, hu, hy, it, gn, gu, ka, kk-Cyr, kk-Lat, kn, ko, ky, lo, lt, lv, mk, no, pl, pt, ro, ru, sk, sl, sr-Cyr, sr-Lat, sv, tg, th, tr, tt, uk, zh.

--voice1-rate <n�mero>
   Sets the rate for the additional voice in a range of -10 to 10 (the default is 0).

--voice1-pitch <n�mero>
   Sets the pitch for the additional voice in a range of -10 to 10 (the default is 0).

--voice1-volume <n�mero>
   Sets the volume for the additional voice in a range of 0 to 100 (the default is 100).

--voice1-roman
   Use the default voice to read Roman numerals in text. If text with non-Latin characters contains Roman numerals, the application will not change a voice to read them.

--voice1-digit
   Use the default voice to read numbers in text.

--voice1-length <n�mero>
   Set the minimal length of foreign text parts that will be read by the additional voice (in characters).


*** Exemplos ***

balcon -l

balcon -n "Microsoft Anna" -m

balcon -f "d:\Text\book.txt" -w "d:\Sound\book.wav" -n "Emma"

balcon -n "Callie" -c -d "d:\rex\rules.rex" -d "d:\dic\rules.dic"

balcon -n "Ricardo" -t "O texto vai ser lido devagar." -s -5 -v 70

balcon -k

balcon -f "d:\Text\book.txt" -w "d:\Sound\book.wav" -lrc --lrc-length 80 --lrc-title "The Lord of the Rings"

balcon -f "d:\Text\film.srt" -w "d:\Sound\film.wav" -n "Laura" --sub-fit --sub-max 2

balcon -f "d:\Text\book.txt" -n Kimberly --voice1-name Tatyana --voice1-langid ru,be


Exemplo de uso do aplicativo em conjunto com o programa utilit�rio LAME.EXE:

balcon -f d:\book.txt -n Celia -o --raw | lame -r -s 22.05 -m m -h - d:\book.mp3


Exemplo de uso do aplicativo em conjunto com o programa utilit�rio OGGENC2.EXE:

balcon -f d:\book.txt -n Celia -o -il | oggenc2 --ignorelength - -o d:\book.ogg


Exemplo de uso do aplicativo em conjunto com o programa utilit�rio WMAENCODE.EXE:

balcon -f d:\book.txt -n Celia -o -il | wmaencode - d:\book.wma --ignorelength


*** Arquivo de configura��o ***

� poss�vel salvar o arquivo de configura��o "balcon.cfg" na mesma pasta que o aplicativo de console.

Um exemplo do conte�do do arquivo:
===============
-f d:\Text\book.txt
-w d:\Sound\book.wav
-n Microsoft Anna
-s 2
-p -1
-v 95
-e 300
-d d:\Dict\rules.bxd
-lrc
--lrc-length 75
--lrc-enc utf8
--lrc-offset 300
===============

O programa pode combinar op��es do arquivo de configura��o e da linha de comando.


*** Audio Clips ***

The application allows to insert links to external WAV files (audio clips) into text. Audio clip tag will look like:

{{Audio=C:\Sounds\ring.wav}}

When speaking text aloud, the program will pause when the audio clip tag is reached, play the audio clip and resume speaking.
When converting to audio files, the audio clip will be embedded in the audio file created by the application.


*** "Voice" Tag ***

If it is necessary to change a voice or its properties during reading aloud, a special tag can be used for SAPI 5 and Microsoft Speech Platform (SAPI 4 voices will ignore this tag).

The tag format:

{{Voice=Name;Rate;Pitch;Volume}}

- Name: the name of a voice (one word or the part of a word is enough);
- Rate: the rate of a voice (values range from -10 to 10);
- Pitch: the pitch of a voice (values range from -10 to 10);
- Volume: the volume (values range from 0 to 100).

A tag applies to all subsequent text. The values are separated by semicolons. For example:

This text will be spoken by the default voice of Balabolka. {{Voice=Kimberly;0;0;100}} The voice 'Kimberly' will read the other text.

The tag's content is case insensitive. Values for some properties can be omitted:

{{voice=eric;;;50}}

{{Voice=Hans;-1}}

{{Voice=Rachel}}

To return to the default voice, use this tag:

{{Voice=}}

Warning! It is impossible to switch between SAPI 5 voices and voices of the Microsoft Speech Platform.


*** "Pause" Tag ***

A specified number of milliseconds of silence can be inserted into the output audio file. For example:

One hundred twenty milliseconds of silence {{Pause=120}} just occurred.


*** Licen�a ***

Direito ao uso n�o comercial do programa: 
- para pessoas singulares: sem restri��es; 
- para pessoas jur�dicas: sujeito �s restri��es contidas no "Contrato de licen�a" do software Balabolka. 

O uso comercial do programa s� � permitido com a autoriza��o pr�via do detentor dos direitos autorais.

###
tools\readme.rus.txt
��������� (���������� ����������), ������ 1.78
Copyright (�) 2013-2021 ���� �������
��� ����� ��������

WWW: http://balabolka-tts.ru/bconsole.html
E-mail: [email protected]

��� ��������: Freeware
������������ �������: Microsoft Windows XP/Vista/7/8/10
Microsoft Speech API: ������ 4.0/5.0 � ����
Microsoft Speech Platform: ������ 11.0



*** ��������� ������ ***

balcon [��������� ...]


*** ��������� ��������� ������ ***

-l
   �������� ������ �������, ������������� �� ����������.

-g
   �������� ������ ��������� ��������������.

-f <���_�����>
   ������� ��������� ����. ��������� ������ ����� ��������� ��������� ���������� [-f].

-fl <���_�����>
   ������� ���� �� ������� ��������� ������ (�� ������ ����� ����� �� ������ ������). ��������� ������ ����� ��������� ��������� ���������� [-fl].

-w <���_�����>
   �������� �������� ���� � ������� WAV. ���� �������� �����, �������� ���� ����� ������. ���� �������� �� �����, ����� ����� �������� �����.

-n <���_������>
   ������� ����� (���������� ������� ����� ��� �����). ���� �������� �� �����, ����� �������������� �����, �������� ��� ������ ��������� [-id],
   ��� �����, ��������� � ������ ���������� Windows.

-id <�����>
   ������� ����� ��� ������ �������������� ����� (Locale ID). ����� �������������� ��������� ������ �������������� �� Microsoft
   (��������, "1049" ��� "0x0419" ��� �������� �����, "1058" ��� "0x0422" ��� �����������). ��������� ������� �� ������ ������ �����, �������������� ����� �������� ��������� � �������� ���������.
   ���� �������� �� �����, ����� �������������� �����, �������� ��� ������ ��������� [-n], ��� �����, ��������� � ������ ���������� Windows.
   ������ ��������������� ��� ������: https://msdn.microsoft.com/en-us/library/cc233982.aspx

-m
   �������� �������������� ���������� ������.

-b <�����>
   ������� ��������������� �� ��� ������ � ������ ��������� ��������� ��� ��������������� �����. ����� ����������, ������������� �� ���������, ����� 0.

-r <�����>
   ������� ��������������� �� ��� ��������.

-c
   ������������ ����� �� ������ ������.

-t <�����>
   ������������ ����� �� ��������� ������. ��������� ������ ����� ��������� ��������� ���������� [-t].

-i
   ������������ ����� �� ������������ ������ ����� (STDIN).

-o
   SAPI 4: �������� �� ������������.
   SAPI 5 � Microsoft Speech Platform: �������� ����������� � ����������� ����� ������ (STDOUT); ���� �������� �����, �������� [-w] ������������.

-s <�����>
   SAPI 4: ���������� �������� ���� � ��������� �� 0 �� 100 (�������� �� ��������� �����������).
   SAPI 5 � Microsoft Speech Platform: ���������� �������� ���� � ��������� �� -10 �� 10 (�� ��������� �������� ����� 0).

-p <�����>
   SAPI 4: ���������� ������ ����� � ��������� �� 0 �� 100 (�������� �� ��������� �����������).
   SAPI 5 � Microsoft Speech Platform: ���������� ������ ����� � ��������� �� -10 �� 10 (�� ��������� �������� ����� 0).

-v <�����>
   SAPI 4: �������� �� ������������.
   SAPI 5 � Microsoft Speech Platform: ���������� ��������� � ��������� �� 0 �� 100 (�� ��������� �������� ����� 100).

-e <�����>
   ���������� ����� ���� ����� ������������� (� �������������). �� ��������� �������� ����� 0.

-a <�����>
   ���������� ����� ���� ����� �������� (� �������������). �� ��������� �������� ����� 0.

-d <���_�����>
   ��������� � ������ ������� ��� ��������� ������������ �� ������� (����� � ����������� *.BXD, *.DIC ��� *.REX). ��������� ������ ����� ��������� ��������� ���������� [-d].
   ������������ ����� ������������� ������� � ���������� "���������".

-k
   ���������� ������ ������ ����������� ����������� ����������, ���������� �� ����������.

-ka
   ���������� ������ ���������� ����������� ����������, ��������� � ������ ������.

-pr
   ��������� �� ����� ��� ����������� ������ ����� ��� ���������� ����������� ����������, ��������� � ������ ������. �������� ���������� ������ ������ ������������ ���� "�����"/"����������".

-q
   �������� ���������� � �������. ���������� ���������� ����� �����, ���� ��������� ���������� ��������� �� �������� ������.

-lrc
   SAPI 4: �������� �� ������������.
   SAPI 5 � Microsoft Speech Platform: ������� ���� ������� LRC, ���� ������ ��������� [-w] ��� [-o].

-srt
   SAPI 4: �������� �� ������������.
   SAPI 5 � Microsoft Speech Platform: ������� ���� ������� SRT, ���� ������ ��������� [-w] ��� [-o].

-vs <file_name>
   SAPI 4: �������� �� ������������.
   SAPI 5 � Microsoft Speech Platform: ������� ��������� ���� � ��������, ���� ����� �������� [-w].
   ������ - ����� ���, ��������������� ������������ ����� ����. SAPI ������������ ������ �� 21 ������.
   ���� ������ ������� �� �������� ���� ��� ���������� �� ������� �������� "Disney". 
   ���������� ���������� ������� �������� ����, � ����� ������������� ��� ��� ����, ����� �������� ������ � ��������� �� �������.
   ������ �����, ������������ SAPI 5: https://msdn.microsoft.com/en-us/library/ms720881(v=vs.85).aspx

-sub
   ����� ������������ ����� �������� � ������ ���� ������������ � �������� ���� � ������ �������� ���������� �������.
   �������� ����� ���� ������� � ��� �������, ����� � ��������� ������ ������ ��������� [-i] ��� [-c].

-tray
   �������� ������ ��������� � ������� ����������� ������������ �������.
   ��� �������� ������������ ������� �� ���������� ���������� ��������, � ����� �������� ������� ��� ������ ������ ������������ ���� "����".

-ln <�����>
   ������� ������ �� ���������� �����, ��������� � �����. ��������� ����� ���������� � "1".
   ��� ������ ���������� ����� ����� ������� ������ ��������� � �������� ����� � ������ (��������, "26-34").
   ��������� ������ ����� ��������� ��������� ���������� [-ln].

-fr <�����>
   SAPI 4: �������� �� ������������.
   SAPI 5 � Microsoft Speech Platform: ���������� ������� ������������� ��� �����������, � ��� (8, 11, 12, 16, 22, 24, 32, 44, 48).
   ���� �������� �� �����, ������������ �������� �� ��������� ��� ���������� ������.

-bt <�����>
   SAPI 4: �������� �� ������������.
   SAPI 5 � Microsoft Speech Platform: ���������� ����������� ��� �����������, � ����� (8 ��� 16).
   ���� �������� �� �����, ������������ �������� �� ��������� ��� ���������� ������.

-ch <�����>
   SAPI 4: �������� �� ������������.
   SAPI 5 � Microsoft Speech Platform: ���������� ����� ��� �����������, ���� ��� ������ (1 ��� 2).
   ���� �������� �� �����, ������������ �������� �� ��������� ��� ���������� ������.

-? ��� -h
   �������� �������� ���������� ��������� ������.

--encoding <���������> ��� -enc <���������>
   ��������� ������ �� ������������ ������ ����� ("ansi", "utf8" ��� "unicode"). �� ��������� �������� ����� "ansi".

--silence-begin <�����> ��� -sb <�����>
   ���������� ����� ����� � ������ ��������� ����� (� �������������). �� ��������� �������� ����� 0.

--silence-end <�����> ��� -se <�����>
   ���������� ����� ����� � ����� ��������� ����� (� �������������). �� ��������� �������� ����� 0.

--lrc-length <�����>
   ���������� ������������ ����� ����� ��� ����� ������� LRC (� ��������).

--lrc-fname <���_�����>
   ��� ����� ������� LRC, ������� ����� ������. �������� ����� ���� ������� � ��� �������, ����� � ��������� ������ ����� �������� [-o].

--lrc-enc <���������>
   ��������� ����� ������� LRC ("ansi", "utf8" ��� "unicode"). �� ��������� �������� ����� "ansi".

--lrc-offset <�����>
   ������ ����� ������� ��� ����� ������� LRC (� �������������).

--lrc-artist <�����>
   ��� ��� ����� ������� LRC: ����������� ������������.

--lrc-album <�����>
   ��� ��� ����� ������� LRC: ������.

--lrc-title <�����>
   ��� ��� ����� ������� LRC: �������� ������������.

--lrc-author <�����>
   ��� ��� ����� ������� LRC: �����.

--lrc-creator <�����>
   ��� ��� ����� ������� LRC: ��������� �����.

--lrc-sent
   �������� ������ ������ ����� ����������� ��� �������� ����� ������� LRC.

--lrc-para
   �������� ������ ������ ����� ������� ��� �������� ����� ������� LRC.

--srt-length <�����>
   ���������� ������������ ����� ����� ��� ����� ������� SRT (� ��������).

--srt-fname <���_�����>
   ��� ����� ������� SRT, ������� ����� ������. �������� ����� ���� ������� � ��� �������, ����� � ��������� ������ ����� �������� [-o].

--srt-enc <���������>
   ��������� ����� ������� SRT ("ansi", "utf8" ��� "unicode"). �� ��������� �������� ����� "ansi".

--raw
   SAPI 4: �������� �� ������������.
   SAPI 5 � Microsoft Speech Platform: �������� ����������� � ������� RAW PCM; ������ �� �������� ��������� ������� WAV. �������� ������������ ��������� � ���������� [-o].

--ignore-length ��� -il
   SAPI 4: �������� �� ������������.
   SAPI 5 � Microsoft Speech Platform: �� ���������� ������ ����������� � ��������� ������� WAV. �������� ������������ ��������� � ���������� [-o].

--sub-format <�����>
   ������ ��������� ("srt", "lrc", "ssa", "ass", "smi" ��� "vtt"), ������� ���������� ������������� � ����. ���� �������� �� �����, ������ ����� ��������� �� ���������� ����� �������� ����� ���������.

--sub-fit ��� -sf
   SAPI 4: �������� �� ������������.
   SAPI 5 � Microsoft Speech Platform: ��� �������������� ��������� � ���� ������������� ����������� �������� ���� ��� ����, ����� ��������� � �������� ��������� �������.

--sub-max <�����> ��� -sm <�����>
   SAPI 4: �������� �� ������������.
   SAPI 5 � Microsoft Speech Platform: ���������� ������������ �������� ���� � ��������� �� -10 �� 10 (��� �������������� ��������� � �������� ����).

--delete-file ��� -df
   ������� ��������� ���� ����� ���������� ������ ����� ��� ���������� ��������� �����. �������� ������������ ��������� � ���������� [-f].

--ignore-square-brackets ��� -isb
   ������������ ����� � [���������� �������].

--ignore-curly-brackets ��� -icb
   ������������ ����� � {�������� �������}.

--ignore-angle-brackets ��� -iab
   ������������ ����� � <������� �������>.

--ignore-round-brackets ��� -irb
   ������������ ����� � (������� �������).

--ignore-url ��� -iu
   ������������ URL-������.

--ignore-comments ��� -ic
   ������������ ����������� � ������. ������������ ����������� ���������� � // � ������������ �� ����� ������. ������������� ����������� ���������� � /* � ����������� */.

--voice1-name <���_������>
   SAPI 4: �������� �� ������������.
   SAPI 5 and Microsoft Speech Platform: ������� �������������� �����, ��������������� ��� ������ ����������� ���� ������ ������ (���������� ������� ����� ����� ������).
   �������� ������������ ��������� � ���������� [--voice1-langid]. ����� ������� ��������� ������� ��� ������ ������ � ������� ���������� [--voice2-name], [--voice3-name] � �.�.

--voice1-langid <�������������_�����>
   ������� ������������� ����� ��� ������ ����������� ���� ������ ������. ��������� ������ � ������ ����� ��������� ����� � ������� ���� ����� ������ ��� ������ ���� ��������.
   �������� ������������ ��������� � ���������� [--voice1-name]. ��������� ������ ����� ��������� ��������� ���������� [--voice1-langid]. ����� ����������� ��������� ��������������� ����� ������� ������ ������ ��������� (��������: "fi,sv").
   ������ ��������������� ������, �������������� ���������� (������������ ���� ��� ����������� �������� ������ �� ��������� ISO 639-1): 
   am, ar, az, ba, bg, be, ca, cs, cu, cv, da, de, el, en, es, et, eu, fi, fil, fr, ja, he, hi, hr, hu, hy, it, gn, gu, ka, kk-Cyr, kk-Lat, kn, ko, ky, lo, lt, lv, mk, no, pl, pt, ro, ru, sk, sl, sr-Cyr, sr-Lat, sv, tg, th, tr, tt, uk, zh.

--voice1-rate <�����>
   ���������� �������� ���� ��� ��������������� ������ � ��������� �� -10 �� 10 (�� ��������� �������� ����� 0).

--voice1-pitch <�����>
   ���������� ������ ����� ��� ��������������� ������ � ��������� �� -10 �� 10 (�� ��������� �������� ����� 0).

--voice1-volume <�����>
   ���������� ��������� ��� ��������������� ������ � ��������� �� 0 �� 100 (�� ��������� �������� ����� 100).

--voice1-roman
   ������������ �������� ����� ��� ������ ������� �����. ���� ��� ������ ��������� ���� ����� �������������� �����, ��������� �� ����� ������ ����� ��� ������ ������� �����. ��������: XVIII ���, ��������� II.

--voice1-digit
   ������������ �������� ����� ��� ������ �����, ��������� �� �������� ����. ���� �������� �� �����, ����� ����� ��������� �������������� �������, ���� ��� ����� ����� � ������������ �������.

--voice1-length <�����>
   ���������� ����������� ����� ������������ ������, ��� ������ �������� ��������� ����� ������������ �������������� ����� (� ��������).


*** ������� ***

������� ��������� ���� �� ������� �������, ������������� �� ����������:

balcon -l > voice.txt


�������� �������������� ������ Microsoft Anna:

balcon -n "Microsoft Anna" -m


������������� ��������� ���� BOOK.TXT � �������� ���� BOOK.WAV:

balcon -f "d:\Text\book.txt" -w "d:\Sound\book.wav" -n Emma


�������� ����� �� ������ ������, ��������� ������� �� �������� ��������� ������������ � �������� �����:

balcon -n Olga -c -d "d:\rex\rules.rex" -d "d:\dic\rules.dic"


�������� ����� �� ��������� ������ � ��������� ��������� � ����������:

balcon -n Alyona -t "����� ����� �������� ��������." -s -5 -v 70


���������� ������ ������ ����������� ����������� ����������:

balcon -k


������������� ����� �� ������������ ������ ����� � �������� ���� BOOK.WAV � ������� ���� BOOK.LRC:

balcon -w "d:\book.wav" -i -lrc --lrc-length 80 --lrc-title "The Lord of the Rings"


�������� ����� ����������, ������� � ����������� ����������� ������� ��������:

balcon -f "d:\Text\book.txt" -n Kimberly --voice1-name Tatyana --voice1-langid ru,be


������������� �������� � �������� ���� FILM.WAV:

balcon -f "d:\Text\film.srt" -w "d:\Sound\film.wav" -n Laura --sub-fit --sub-max 2


������ ������������� ���������� ��������� � �������� LAME.EXE:

balcon -f d:\book.txt -n Alyona -o --raw | lame -r -s 22.05 -m m -h - d:\book.mp3


������ ������������� ���������� ��������� � �������� OGGENC2.EXE:

balcon -f d:\book.txt -n Alyona -o -il | oggenc2 --ignorelength - -o d:\book.ogg


������ ������������� ���������� ��������� � �������� WMAENCODE.EXE:

balcon -f d:\book.txt -n Alyona -o -il | wmaencode - d:\book.wma --ignorelength


*** ���� ������������ ***

��������� ����� ��������� ��� ���� ������������ "balcon.cfg" � ��� �� �����, ��� � ���������� ����������.

������ ����������� �����:
===============
-f d:\Text\book.txt
-w d:\Sound\book.wav
-n Microsoft Anna
-s 2
-p -1
-v 95
-e 300
-d d:\Dict\rules.bxd
-lrc
--lrc-length 75
--lrc-enc utf8
--lrc-offset 300
===============

��������� ����� ������������� ��������� �� ����� ������������ � ��������� ������.


*** ���������� ***

��������� ��������� ��������� ������ �� ������� �������� ����� �������� WAV � MP3 (����������) � �����. ��� ������� ���������� ����� ��������� ���:

{{Audio=C:\Sounds\ring.wav}}

�� ����� ������ �����, ����� � ������ ���������� ������ �� ���������, ��������� ����� ���������������� ����, �������������� ���������, � ����� ���������� ������.
��� ������ ���� � ���� ��������� ������� ����������� �� �������� ��������� ����� ������ ������ �����.


*** ��� Voice ***

���� ���������� �������� ����� ��� ��� ��������, ����������� ��� ����� ���� ����������� ��� SAPI 5 � Microsoft Speech Platform (������ SAPI 4 ����� ������������ ���� ���).

������ ����:

{{Voice=��������;��������;������;���������}}

- ��������: �������� ������ (���������� ������ ����� ��� ���� ����� �����);
- ��������: �������� ������ (�������� ������ ���������� ����� -10 � 10);
- ������: ������ ����� (�������� ������ ���������� ����� -10 � 10);
- ���������: ��������� ���� (�������� ������ ���������� ����� 0 � 100).

������� �������� ���� ���������������� �� ���� ����������� �����. �������� ��������� ������ ���� ��������� ������ � �������. ��������:

��������� ��������� ���� ����� �������� �������. {{Voice=Alyona;0;0;100}} ����� '����' ��������� ��������� �����.

���������� ���� �� ������� �� �������� ����. �������� ��������� ��������� ����� ���� ���������:

{{voice=yuri;;;50}}

{{Voice=Hans;-1}}

{{Voice=Aleksandr}}

����� ��������� � ��������� ������, ���������� � ���������, ����������� ���� ���:

{{Voice=}}

��������! ��� ������ ����� ���������� ������������� ����� �������� SAPI 5 � �������� Microsoft Speech Platform.


*** ��� Pause ***

����� ��������� ����������� ����� � ����, � ������� ���� ����� �������� �����. ������������ ����� ������ ���� ������� � �������������.

������ ��������� ��� �������. {{Pause=2000}} ����� ������ ������������.


*** �������� ***

������������ ������������� ��������� ����������� ������ � ���������� ���������������.

����������� ������������� ������������ �������� �� �����������, ������������� ������� ��������������� ������ � ������� �������� �������������� ���������� ���������, ��������������� � �������� ������� ���������� ���������, ����������� �������������� ���������� ������������ ������. ����������� ������������� ������������ �������� �� �����������, ������������� ������������������ ������� � ����������� ������� ���������� ���������, ���������� ����� ���������� ���������. ����������� ������������� ��������� ������������ ������������� � ������������� � ���������� ���������. ����������� ������������� ��������� � ����������� ������� ��������, ����������� ������-������� ��������, ��������� ��������, ��������� ������� ��������������� ����������. ����������� ������������� ������������ �������� �� �����������, ������������� "�������������� ������ ��������� �������� ������� �������� ������", "��������������� ��������� ������", �������������� �����������-��������������� ����������� "���� ������ ������" � �������������� ����������� ������-��������������� ������������� �������� "�������". ����������� ������������� ��������� �� �����������, ����������� � ������ ����������� ������ � ����������� ����������������� �����������, � ����� ������ �� �����. ����������� ������������� ������������ �������� �� ���������� ��������� ���������� ����, ��������� �������-��������������� ����������, ���������� ��������, ���������� ����, ��������� �������� ����������, ��������� ����������, � ����� �� ���������� ����������� ����.

###
tools\readme.spa.txt
Balabolka (aplicaci�n de consola), versi�n 1.78
Copyright (c) 2013-2021 Ilya Morozov
Todos los derechos reservados

WWW: http://balabolka.site/es/bconsole.htm
Correo electr�nico: [email protected]

Licencia: Gratuito (Freeware)
Sistema operativo: Microsoft Windows XP/Vista/7/8/10
Microsoft Speech API: 4.0/5.0 y superiores
Microsoft Speech Platform: 11.0



*** Uso ***

balcon [opciones ...]


*** Opciones de la l�nea de comandos ***

-l
   Muestra la lista de voces disponibles.

-g
   Muestra la lista de dispositivos de salida de audio disponibles.

-f <archivo de texto>
   Establece el nombre del archivo de texto de entrada. La l�nea de comandos puede contener varias opciones [-f].

-fl <nombre_de_archivo>
   Establece el nombre del archivo de texto con la lista de archivos de entrada (un nombre de archivo por l�nea). La l�nea de comandos puede contener varias opciones [-fl].

-w <archivo de onda>
   Establece el nombre del archivo de salida en formato WAV. Si se especifica la opci�n, se crear� un archivo de audio. De lo contrario, el texto ser� le�do en voz alta.

-n <nombre_de_voz>
   Nombre de la voz (basta especificar una parte del nombre). Si no se especifica, se usar� la voz seleccionada en el panel de control de Windows.

-id <entero>
   Establece el identificador de idioma (Locale ID) de la voz. El identificador de idioma es el c�digo de idioma asignado por Microsoft
   (por ejemplo, "1033" o "0x0409" para "ingl�s - Estados Unidos", "3082" o "0x0C0A" para "espa�ol - alfabetizaci�n internacional").
   El programa escoger� de la lista la primera voz cuyo identificador de idioma coincida con el valor especificado.
   Si no se especifica el par�metro, se utilizar� la voz, especificada con ayuda del par�metro [-n], o la voz seleccionada en el panel de control de Windows.
   Lista de identificadores de idioma: https://msdn.microsoft.com/en-us/library/cc233982.aspx

-m
   Muestra los par�metros de la voz.

-b <entero>
   Establece el dispositivo de salida de audio por su �ndice. El �ndice del dispositivo de audio predeterminado es 0.

-r <texto>
   Establece el dispositivo de salida de audio por su nombre.

-c
   Toma como entrada el texto del portapapeles.

-t <texto>
   El texto de entrada se puede tomar de la l�nea de comandos. La l�nea de comandos puede contener varias opciones [-t].

-i
   Toma el texto de entrada de STDIN.

-o
   SAPI 4: la opci�n no se usa.
   SAPI 5 y Microsoft Speech Platform: escribe los datos sonoros en STDOUT. Si se especifica la opci�n, la opci�n [-w] se ignora.

-s <entero>
   SAPI 4: establece la velocidad de la voz en el rango de 0 a 100 (no hay valor predeterminado).
   SAPI 5 y Microsoft Speech Platform: establece la velocidad de la voz en el rango de -10 a 10 (el valor predeterminado es 0).

-p <entero>
   SAPI 4: establece el tono de la voz en el rango de 0 a 100 (no hay valor predeterminado).
   SAPI 5 y Microsoft Speech Platform: establece el tono de la voz en el rango de -10 a 10 (el valor predeterminado es 0).

-v <entero>
   SAPI 4: la opci�n no se usa.
   SAPI 5 y Microsoft Speech Platform: establece el volumen en el rango de 0 a 100 (el valor predeterminado es 100).

-e <entero>
   Ajusta la longitud de las pausas entre frases (en milisegundos). El valor predeterminado es 0.

-a <entero>
   Ajusta la longitud de las pausas entre p�rrafos (en milisegundos). El valor predeterminado es 0.

-d <nombre_de_archivo>
   Usa un diccionario para la correcci�n de la pronunciaci�n (*.BXD, *.DIC o *.REX). La l�nea de comandos puede contener varias opciones [-d].

-k
   Elimina otras copias de la aplicaci�n de consola de la memoria del equipo.

-ka
   Elimina de la memoria del equipo la copia de la aplicaci�n de consola activa.

-pr
   Pausa o reanuda la lectura en voz alta por parte de la copia activa de la aplicaci�n. Es la misma acci�n que la del elemento del men� contextual "Pausa"/"Reanudar".

-q
   A�ade la aplicaci�n a una cola. La aplicaci�n de consola esperar� hasta que otras copias del programa finalicen.

-lrc
   SAPI 4: la opci�n no se usa.
   SAPI 5 y Microsoft Speech Platform: Si se especifican las opciones [-w] u [-o], crea el archivo LRC.

-srt
   SAPI 4: la opci�n no se usa.
   SAPI 5 y Microsoft Speech Platform: Si se especifican las opciones [-w] u [-o], crea el archivo SRT.

-vs <nombre_de_archivo>
   SAPI 4: la opci�n no se usa.
   SAPI 5 y Microsoft Speech Platform: establece el nombre del archivo de texto de salida con visemas, si se especifica la opci�n [-w].
   Un visema es la forma de la boca correspondiente a un sonido en particular al hablar. SAPI es compatible con la lista de 21 visemas.
   Esta lista est� basada en los visemas originales de Disnei. La aplicaci�n crear� el archivo de audio y lo leer� en voz alta para obtener los visemas y sus c�digos de tiempo.
   La lista de visemas compatibles con SAPI 5: https://msdn.microsoft.com/en-us/library/ms720881(v=vs.85).aspx

-sub
   El texto se procesar� como subt�tulos. La opci�n puede ser �til al especificar las opciones [-i] o [-c].

-tray
   Muestra el icono del programa en la bandeja del sistema. Ello permite observar el progreso de la tarea.
   Puede utilizarse el elemento "Stop" del men� contextual para detener el proceso.

-ln <entero>
   Selecciona una l�nea del archivo de texto empleando un n�mero de l�nea. La numeraci�n de las l�neas empieza por "1".
   Para seleccionar m�s de una l�nea se puede emplear el intervalo de n�meros (por ejemplo, "26-34").
   La l�nea de comandos puede contener varias opciones [-ln].

-fr <entero>
   SAPI 4: la opci�n no se usa.
   SAPI 5 y Microsoft Speech Platform: establece la frecuencia de muestreo de la salida de audio en kHz (8, 11, 12, 16, 22, 24, 32, 44, 48).
   Si no se especifica la opci�n, se utilizar� el valor predeterminado de la voz seleccionada.

-bt <entero>
   SAPI 4: la opci�n no se usa.
   SAPI 5 y Microsoft Speech Platform: establece la profundidad en bits del audio de salida (8 o 16).
   Si no se especifica la opci�n, se utilizar� el valor predeterminado de la voz seleccionada.

-ch <entero>
   SAPI 4: la opci�n no se usa.
   SAPI 5 y Microsoft Speech Platform: establece el modo de canal del audio de salida (1 o 2).
   Si no se especifica la opci�n, se utilizar� el valor predeterminado de la voz seleccionada.

-? o -h
   Muestra la lista de opciones de l�nea de comandos disponibles.

--encoding <codificaci�n> o -enc <codificaci�n>
   Establece la codificaci�n del texto de entrada ("ansi", "utf8" o "unicode"). El valor predeterminado es "ansi".

--silence-begin <entero> o -sb <entero>
   Ajusta la longitud del silencio al principio del archivo de audio (en milisegundos). El valor predeterminado es 0.

--silence-end <entero> o -se <entero>
   Ajusta la longitud del silencio al final del archivo de audio (en milisegundos). El valor predeterminado es 0.

--lrc-length <entero>
   Ajusta la longitud m�xima de l�neas para el archivo LRC (en caracteres).

--lrc-fname <nombre_de_fichero>
   Establece el nombre del archivo LRC. La opci�n puede ser �til cuando se especifica la opci�n [-o].

--lrc-enc <codificaci�n>
   Establece la codificaci�n del archivo LRC ("ansi", "utf8" o "unicode"). El valor predeterminado es "ansi".

--lrc-offset <entero>
   Ajusta el desplazamiento del tiempo para el archivo LRC (en milisegundos).

--lrc-artist <texto>
   Establece la etiqueta de ID para el archivo LRC: int�rprete.

--lrc-album <texto>
   Establece la etiqueta de ID para el archivo LRC: �lbum.

--lrc-title <texto>
   Establece la etiqueta de ID para el archivo LRC: t�tulo.

--lrc-author <texto>
   Establece la etiqueta de ID para el archivo LRC: autor.

--lrc-creator <texto>
   Establece la etiqueta de ID para el archivo LRC: creador del archivo LRC.

--lrc-sent
   Inserta l�neas en blanco despu�s de las frases en el archivo LRC.

--lrc-para
   Inserta l�neas en blanco despu�s de los p�rrafos en el archivo LRC.

--srt-length <entero>
   Ajusta la longitud m�xima de l�neas para el archivo SRT (en caracteres).

--srt-fname <nombre_de_fichero>
   Establece el nombre del archivo SRT. La opci�n puede ser �til cuando se especifica la opci�n [-o].

--srt-enc <codificaci�n>
   Establece la codificaci�n del archivo SRT ("ansi", "utf8" o "unicode"). El valor predeterminado es "ansi".

--raw
   SAPI 4: la opci�n no se usa.
   SAPI 5 y Microsoft Speech Platform: grabar los datos de audio en el formato RAW PCM; los datos no contienen el encabezado del formato WAV.
   La opci�n se utiliza junto con la opci�n [-o].

--ignore-length o -il
   SAPI 4: la opci�n no se usa.
   SAPI 5 y Microsoft Speech Platform: no grabar la dimensi�n de los datos de audio en el encabezado del formato WAV. La opci�n se utiliza junto con la opci�n [-o].

--sub-format <texto>
   Establece el formato de subt�tulos ("srt", "lrc", "ssa", "ass", "smi" o "vtt"). Si no se especifica la opci�n, el formato se definir� seg�n la extensi�n del archivo.

--sub-fit o -sf
   SAPI 4: la opci�n no se usa.
   SAPI 5 y Microsoft Speech Platform: aumenta autom�ticamente la velocidad del habla para que se ajuste a los intervalos de tiempo, al convertir subt�tulos en un archivo de audio.

--sub-max <entero> o -sm <entero>
   SAPI 4: la opci�n no se usa.
   SAPI 5 y Microsoft Speech Platform: ajusta la velocidad m�xima del habla en la gama de -10 a 10 (para convertir los subt�tulos en un archivo de audio).

--delete-file o -df
   Al terminar el trabajo, borra el archivo de texto. La opci�n se utiliza junto con la opci�n [-f].

--ignore-square-brackets o -isb
   Ignorar el texto entre [corchetes cuadrados].

--ignore-curly-brackets o -icb
  Ignorar el texto entre {llaves}.

--ignore-angle-brackets o -iab
  Ignora el texto entre <corchetes angulares>.

--ignore-round-brackets o -irb
   Ignorar texto entre (corchetes redondos).

--ignore-url o -iu
   Ignorar las URL.

--ignore-comments o -ic
   Omite los comentarios. Los comentarios de una sola l�nea comienzan con // y contin�an hasta el final de la l�nea. Los comentarios de varias l�neas comienzan con /* y terminan con */.

--voice1-name <nombre_de_voz>
   SAPI 4: la opci�n no se usa.
   SAPI 5 y Microsoft Speech Platform: establece el nombre de la voz adicional para leer palabras del texto en otros idiomas (bastar� con parte del nombre).
   La opci�n se utiliza junto con la opci�n [--voice1-langid]. Pueden establecerse otras voces con las opciones [--voice2-name], [--voice3-name], etc.

--voice1-langid <ID_de_idioma>
   Establece el identificador de idioma para palabras del texto que est�n en otros idiomas. La opci�n se utiliza junto con la opci�n [--voice1-name]. La l�nea de comandos puede contener m�s de una opci�n [--voice1-langid]. Adem�s, una opci�n puede contener una lista de identificadores separados por comas.
   La lista de identificadores de idioma compatibles est� basada en los c�digos ISO 639-1: am, ar, az, ba, bg, be, ca, cs, cu, cv, da, de, el, en, es, et, eu, fi, fil, fr, ja, he, hi, hr, hu, hy, it, gn, gu, ka, kk-Cyr, kk-Lat, kn, ko, ky, lo, lt, lv, mk, no, pl, pt, ro, ru, sk, sl, sr-Cyr, sr-Lat, sv, tg, th, tr, tt, uk, zh.

--voice1-rate <entero>
  Ajusta la velocidad de la voz adicional en la gama de -10 a 10 (la predeterminada es 0).

--voice1-pitch <entero>
  Ajusta el tono de la voz adicional en la gama de -10 a 10 (el predeterminado es 0).

--voice1-volume <entero>
  Ajusta el volumen de la voz adicional en la gama de 0 a 100 (el predeterminado es 100).

--voice1-roman
   Para leer n�meros romanos en el texto, utiliza la voz predeterminada. Si un texto con caracteres no latinos contiene n�meros romanos, la aplicaci�n no cambiar� de voz para leerlos.

--voice1-digit
   Para leer n�meros en el texto, utiliza la voz predeterminada.

--voice1-length <entero>
   Establece la longitud m�nima de las partes de texto en otros idiomas que leer� la voz adicional (en caracteres).


*** Ejemplos ***

balcon -l

balcon -n "Microsoft Anna" -m

balcon -f "d:\Texto\libro.txt" -w "d:\Sonido\libro.wav" -n "Emma"

balcon -n "Callie" -c -d "d:\rex\reglas.rex" -d "d:\dic\reglas.dic"

balcon -n "Conchita" -t "El texto ser� le�do lentamente." -s -5 -v 70

balcon -k

balcon -f "d:\Texto\libro.txt" -w "d:\Sonido\libro.wav" -lrc --lrc-length 80 --lrc-title "El Se�or de los Anillos"

balcon -f "d:\Texto\film.srt" -w "d:\Sonido\film.wav" -n "Laura" --sub-fit --sub-max 2

balcon -f "d:\Texto\libro.txt" -n Diego --voice1-name Tatyana --voice1-langid ru


Ejemplo de utilizaci�n de la aplicaci�n junto con la utilidad LAME.EXE:

balcon -f d:\libro.txt -n Ines -o --raw | lame -r -s 22.05 -m m -h - d:\libro.mp3


Ejemplo de utilizaci�n de la aplicaci�n junto con la utilidad OGGENC2.EXE:

balcon -f d:\libro.txt -n Ines -o -il | oggenc2 --ignorelength - -o d:\libro.ogg


Ejemplo de utilizaci�n de la aplicaci�n junto con la utilidad WMAENCODE.EXE:

balcon -f d:\libro.txt -n Ines -o -il | wmaencode - d:\libro.wma --ignorelength


*** Archivo de configuraci�n ***

Se puede guardar el archivo de configuraci�n "balcon.cfg" en la misma carpeta que la aplicaci�n de consola.

Un ejemplo del contenido del archivo:
===============
-f d:\Texto\libro.txt
-w d:\Sonido\libro.wav
-n Microsoft Anna
-s 2
-p -1
-v 95
-e 300
-d d:\Dicc\reglas.bxd
-lrc
--lrc-length 75
--lrc-enc utf8
--lrc-offset 300
===============

El programa puede combinar opciones del archivo de configuraci�n y de la l�nea de comandos.


*** Clips de audio ***

La aplicaci�n permite insertar v�nculos a archivos WAV externos (clips de audio) en el texto. La etiqueta de clip de audio ser� similar a esto:

{{Audio=C:\Sonidos\timbre.wav}}

Al leer el texto en voz alta, el programa se pausar� cuando llegue a la etiqueta del clip de audio, reproducir� el clip de audio y seguir� hablando.
Al convertir en archivos de audio, el clip de audio se incrustar� en el archivo de audio que cree la aplicaci�n.


*** Etiqueta "Voice" ***

Si durante la lectura en voz alta fuera necesario cambiar la voz o sus propiedades, para SAPI 5 y Microsoft Speech Platform se puede usar una etiqueta especial (las voces SAPI 4 la ignorar�n).

El formato de la etiqueta:

{{Voice=Nombre;Velocidad;Tono;Volumen}}

- Nombre: el nombre de alguna voz (basta con una palabra o parte de �sta);
- Velocidad: la velocidad de la voz (los valores van de -10 a 10);
- Tono: el tono de la voz (los valores van de -10 a 10);
- Volumen: el volumen (los valores van de 0 a 100).

La etiqueta se aplica a todo el texto que le siga. Los valores se separan por punto y comas. Por ejemplo:

Este texto lo leer� la voz de Balabolka predeterminada. {{Voice=Esperanza;0;0;100}} El otro texto lo leer� la voz Marta.

EL contenido de la etiqueta no distingue entre may�sculas y min�sculas. Pueden omitirse los valores de algunas propiedades:

{{voice=enrique;;;50}}

{{Voice=Pablo;-1}}

{{Voice=Rosa}}

Para volver a la voz predeterminada, use esta etiqueta:

{{Voice=}}

Aviso: Es imposible cambiar entre voces SAPI 5 y voces de Microsoft Speech Platform.


*** Etiqueta "Pause" ***

Se puede insertar el n�mero especificado de milisegundos de silencio en el archivo de audio de salida. Por ejemplo:

Ciento veinte milisegundos de silencio {{Pause=120}} acabaron de pasar.


*** Licencia ***

Es libre de utilizar y distribuir el software sin fines comerciales. Para uso o distribuci�n con fines comerciales, tiene que obtener permiso del titular de los derechos de autor. La aplicaci�n no se puede utilizar en el territorio de Belar�s, Cuba, Ir�n, Corea del Norte, Syria ni en la Regi�n de Crimea.

###

Log in or click on link to see number of positives.

In cases where actual malware is found, the packages are subject to removal. Software sometimes has false positives. Moderators do not necessarily validate the safety of the underlying software, only that a package retrieves software from the official distribution point and/or validate embedded software against official distribution point (where distribution rights allow redistribution).

Chocolatey Pro provides runtime protection from possible malware.

Version Downloads Last Updated Status
Balabolka Console (balcon) 1.77 30 Friday, May 14, 2021 Approved
Balabolka Console (balcon) 1.75 34 Thursday, April 8, 2021 Approved
Balabolka Console (balcon) 1.74 25 Saturday, March 20, 2021 Approved
Balabolka Console (balcon) 1.73 38 Sunday, March 14, 2021 Approved

This package has no dependencies.

Discussion for the Balabolka Console (balcon) Package

Ground Rules:

  • This discussion is only about Balabolka Console (balcon) and the Balabolka Console (balcon) package. If you have feedback for Chocolatey, please contact the Google Group.
  • This discussion will carry over multiple versions. If you have a comment about a particular version, please note that in your comments.
  • The maintainers of this Chocolatey Package will be notified about new comments that are posted to this Disqus thread, however, it is NOT a guarantee that you will get a response. If you do not hear back from the maintainers after posting a message below, please follow up by using the link on the left side of this page or follow this link to contact maintainers. If you still hear nothing back, please follow the package triage process.
  • Tell us what you love about the package or Balabolka Console (balcon), or tell us what needs improvement.
  • Share your experiences with the package, or extra configuration or gotchas that you've found.
  • If you use a url, the comment will be flagged for moderation until you've been whitelisted. Disqus moderated comments are approved on a weekly schedule if not sooner. It could take between 1-5 days for your comment to show up.
comments powered by Disqus