Step 1: Review Your Packages

Step 2: Choose Your Integration Method

Step 3: Copy Your Script or Download Config

Option 1: Copy Script

Option 2: Download Config

Step 4: Setup Your Environment

1. Ensure you are set for organizational deployment

Please see the organizational deployment guide

2. Get the package into your environment

Option 1: Cached Package (Unreliable, Requires Internet - Same As Community)

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 packages and push them to a repository
  Download Packages

Option 2: Internalized Package (Reliable, Scalable)

Open Source
- Download the packages:
  Download Packages
- Follow manual internalization instructions
Package Internalizer (C4B)
- Run: (additional options)
- For package and dependencies run:
- Automate package internalization

Step 5: Copy Your Script

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:

If Applicable - Chocolatey Configuration/Installation


## 1. REQUIREMENTS ##
### Here are the requirements necessary to ensure this is successful.

### a. Internal/Private Cloud Repository Set Up ###
#### You'll need an internal/private cloud repository you can use. These are
####  generally really quick to set up and there are quite a few options.
####  Chocolatey Software recommends Nexus, Artifactory Pro, or ProGet as they
####  are repository servers and will give you the ability to manage multiple
####  repositories and types from one server installation.

### b. Download Chocolatey Package and Put on Internal Repository ###
#### You need to have downloaded the Chocolatey package as well.
####  Please see https://chocolatey.org/install#organization

### c. Other Requirements ###

#### We initialize a few things that are needed by this script - there are no other requirements.
$ErrorActionPreference = "Stop"

#### Set TLS 1.2 (3072) as that is the minimum required by various up-to-date repositories.
#### Use integers because the enumeration value for TLS 1.2 won't exist
#### in .NET 4.0, even though they are addressable if .NET 4.5+ is
#### installed (.NET 4.5 is an in-place upgrade).
[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072

#### We use this variable for future REST calls.
$RequestArguments = @{
    UseBasicParsing = $true
}

## 2. TOP LEVEL VARIABLES ##

### a. Your internal repository url (the main one). ###
####  Should be similar to what you see when you browse
#### to https://community.chocolatey.org/api/v2/
$NugetRepositoryUrl = "INTERNAL REPO URL"

### b. Internal Repository Credential ###
#### If required, add the repository access credential here
# $NugetRepositoryCredential = [PSCredential]::new(
#     "username",
#     ("password" | ConvertTo-SecureString -AsPlainText -Force)
# )
# $RequestArguments.Credential = $NugetRepositoryCredential

### c. Chocolatey nupkg download url ###
#### This url should result in an immediate download when you navigate to it
$ChocolateyDownloadUrl = "$($NugetRepositoryUrl.TrimEnd('/'))/package/chocolatey.2.2.2.nupkg"

### d. Chocolatey Central Management (CCM) ###
#### If using CCM to manage Chocolatey, add the following:
#### i. Endpoint URL for CCM
# $ChocolateyCentralManagementUrl = "https://chocolatey-central-management:24020/ChocolateyManagementService"

#### ii. If using a Client Salt, add it here
# $ChocolateyCentralManagementClientSalt = "clientsalt"

#### iii. If using a Service Salt, add it here
# $ChocolateyCentralManagementServiceSalt = "servicesalt"

## 3. ENSURE CHOCOLATEY IS INSTALLED ##
### Ensure Chocolatey is installed from your internal repository

#### Download the Nupkg, appending .zip to the filename to handle archive cmdlet limitations
if (-not (Get-Command choco.exe -ErrorAction SilentlyContinue)) {
    $TempDirectory = Join-Path $env:Temp "chocolateyInstall"
    if (-not (Test-Path $TempDirectory -PathType Container)) {
        $null = New-Item -Path $TempDirectory -ItemType Directory
    }
    $DownloadedNupkg = Join-Path $TempDirectory "$(Split-Path $ChocolateyDownloadUrl -Leaf).zip"
    Invoke-WebRequest -Uri $ChocolateyDownloadUrl -OutFile $DownloadedNupkg @RequestArguments

    #### Extract the Nupkg, and run the chocolateyInstall script
    if (Get-Command Microsoft.PowerShell.Archive\Expand-Archive -ErrorAction SilentlyContinue) {
        Microsoft.PowerShell.Archive\Expand-Archive -Path $DownloadedNupkg -DestinationPath $TempDirectory -Force
    } else {
        # PowerShell versions <4.0 do not have this function available
        try {
            $shellApplication = New-Object -ComObject Shell.Application
            $zipPackage = $shellApplication.NameSpace($DownloadedNupkg)
            $destinationFolder = $shellApplication.NameSpace($TempDirectory)
            $destinationFolder.CopyHere($zipPackage.Items(), 0x10)
        } catch {
            Write-Warning "Unable to unzip package using built-in compression."
            throw $_
        }
    }

    & $(Join-Path $TempDirectory "tools\chocolateyInstall.ps1")
}

if (-not (Get-Command choco.exe -ErrorAction SilentlyContinue)) {
    refreshenv
}

## 4. CONFIGURE CHOCOLATEY BASELINE ##
### a. FIPS Feature ###
#### If you need FIPS compliance - make this the first thing you configure
#### before you do any additional configuration or package installations
# choco feature enable -n useFipsCompliantChecksums

### b. Apply Recommended Configuration ###
#### Move cache location so Chocolatey is very deterministic about
#### cleaning up temporary data and the location is secured to admins
choco config set --name cacheLocation --value C:\ProgramData\chocolatey\cache

#### Increase timeout to at least 4 hours
choco config set --name commandExecutionTimeoutSeconds --value 14400

#### Turn off download progress when running choco through integrations
choco feature disable --name showDownloadProgress

### c. Sources ###
#### Remove the default community package repository source
choco source list --limitoutput | ConvertFrom-Csv -Header 'Name', 'Location' -Delimiter '|' | ForEach-Object {
    if ($_.Location -eq 'https://community.chocolatey.org/api/v2/') {
        choco source remove -n $_.Name
    }
}

#### Add internal default sources
#### You could have multiple sources here, so we will provide an example
#### of one using the remote repo variable here

#### NOTE: This EXAMPLE may require changes
if ($NugetRepositoryCredential) {
    choco source add --name ChocolateyInternal --source $NugetRepositoryUrl --user $NugetRepositoryCredential.UserName --password $NugetRepositoryCredential.GetNetworkCredential().Password --priority 1
} else {
    choco source add --name ChocolateyInternal --source $NugetRepositoryUrl --priority 1
}

### b. Keep Chocolatey Up To Date ###
#### Keep chocolatey up to date based on your internal source
#### You control the upgrades based on when you push an updated version
####  to your internal repository.
#### Note the source here is to the OData feed, similar to what you see
####  when you browse to https://community.chocolatey.org/api/v2/
choco upgrade chocolatey --confirm

## 5. ENSURE CHOCOLATEY FOR BUSINESS ##
### If you don't have Chocolatey for Business (C4B), you'll want to remove from here down.

### a. Ensure The License File Is Installed ###
#### Create a license package using script from https://docs.chocolatey.org/en-us/how-tos/setup-offline-installation#exercise-4-create-a-package-for-the-license
choco install chocolatey-license --source $NugetRepositoryUrl --confirm

### b. Disable The Licensed Source ###
#### The licensed source cannot be removed, so it must be disabled.
#### This must occur after the license has been set by the license package.
if ("chocolatey-license" -in (choco list --localonly --limitoutput | ConvertFrom-Csv -Header "Name" -Delimiter "|").Name) {
    choco source disable --name chocolatey.licensed
} else {
    Write-Warning "Not disabling 'chocolatey.licensed' feed, as Chocolatey-License has not been installed."
}

### c. Ensure Chocolatey Licensed Extension ###
#### You will have downloaded the licensed extension to your internal repository
#### as you have disabled the licensed repository in step 5b.

#### Ensure the chocolatey.extension package (aka Chocolatey Licensed Extension)
if ("chocolatey-license" -in (choco list --localonly --limitoutput | ConvertFrom-Csv -Header "Name" -Delimiter "|").Name) {
    choco install chocolatey.extension --source $NugetRepositoryUrl --confirm
} else {
    Write-Warning "Not installing 'chocolatey.extension', as Chocolatey-License has not been installed."
}

#### The Chocolatey Licensed Extension unlocks all of the following, which also have configuration/feature items available with them. You may want to visit the feature pages to see what you might want to also enable:
#### - Package Builder - https://docs.chocolatey.org/en-us/features/paid/package-builder
#### - Package Internalizer - https://docs.chocolatey.org/en-us/features/paid/package-internalizer
#### - Package Synchronization (3 components) - https://docs.chocolatey.org/en-us/features/paid/package-synchronization
#### - Package Reducer - https://docs.chocolatey.org/en-us/features/paid/package-reducer
#### - Package Audit - https://docs.chocolatey.org/en-us/features/paid/package-audit
#### - Package Throttle - https://docs.chocolatey.org/en-us/features/paid/package-throttle
#### - CDN Cache Access - https://docs.chocolatey.org/en-us/features/paid/private-cdn
#### - Branding - https://docs.chocolatey.org/en-us/features/paid/branding
#### - Self-Service Anywhere (more components will need to be installed and additional configuration will need to be set) - https://docs.chocolatey.org/en-us/features/paid/self-service-anywhere
#### - Chocolatey Central Management (more components will need to be installed and additional configuration will need to be set) - https://docs.chocolatey.org/en-us/features/paid/chocolatey-central-management
#### - Other - https://docs.chocolatey.org/en-us/features/paid/

### d. Ensure Self-Service Anywhere ###
#### If you have desktop clients where users are not administrators, you may
#### to take advantage of deploying and configuring Self-Service anywhere
choco feature disable --name showNonElevatedWarnings
choco feature enable --name useBackgroundService
choco feature enable --name useBackgroundServiceWithNonAdministratorsOnly
choco feature enable --name allowBackgroundServiceUninstallsFromUserInstallsOnly
choco config set --name allowedBackgroundServiceCommands --value "install,upgrade,uninstall"

### e. Ensure Chocolatey Central Management ###
#### If you want to manage and report on endpoints, you can set up and configure
### Central Management. There are multiple portions to manage, so you'll see
### a section on agents here along with notes on how to configure the server
### side components.
if ($ChocolateyCentralManagementUrl) {
    choco install chocolatey-agent --source $NugetRepositoryUrl --confirm
    choco config set --name CentralManagementServiceUrl --value $ChocolateyCentralManagementUrl
    if ($ChocolateyCentralManagementClientSalt) {
        choco config set --name centralManagementClientCommunicationSaltAdditivePassword --value $ChocolateyCentralManagementClientSalt
    }
    if ($ChocolateyCentralManagementServiceSalt) {
        choco config set --name centralManagementServiceCommunicationSaltAdditivePassword --value $ChocolateyCentralManagementServiceSalt
    }
    choco feature enable --name useChocolateyCentralManagement
    choco feature enable --name useChocolateyCentralManagementDeployments
}

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

If Applicable - Chocolatey Configuration/Installation


## 1. REQUIREMENTS ##
### Here are the requirements necessary to ensure this is successful.

### a. Internal/Private Cloud Repository Set Up ###
#### You'll need an internal/private cloud repository you can use. These are
####  generally really quick to set up and there are quite a few options.
####  Chocolatey Software recommends Nexus, Artifactory Pro, or ProGet as they
####  are repository servers and will give you the ability to manage multiple
####  repositories and types from one server installation.

### b. Download Chocolatey Package and Put on Internal Repository ###
#### You need to have downloaded the Chocolatey package as well.
####  Please see https://chocolatey.org/install#organization

### c. Other Requirements ###
#### i. chocolatey.chocolatey
##### You will require the chocolatey.chocolatey collection to be installed
##### on all machines using this playbook.
##### Please see https://github.com/chocolatey/chocolatey-ansible/#installing-the-collection-from-ansible-galaxy

- name: Install and Configure Chocolatey
  hosts: all

## 2. TOP LEVEL VARIABLES ##
  vars:

### a. Your internal repository url (the main one). ###
####  Should be similar to what you see when you browse
#### to https://community.chocolatey.org/api/v2/
    nuget_repository_url: INTERNAL REPO URL

### b. Internal Repository Credential ###
#### If required, add the repository access credential here and
#### uncomment lines with source_username and source_password below
#    nuget_repository_username: username
#    nuget_repository_password: password

### c. Chocolatey Central Management (CCM) ###
#### If using CCM to manage Chocolatey, add the following:
#### i. Endpoint URL for CCM
#    chocolatey_central_management_url: https://chocolatey-central-management:24020/ChocolateyManagementService

#### ii. If using a Client Salt, add it here
#    chocolatey_central_management_client_salt: clientsalt

#### iii. If using a Service Salt, add it here
#    chocolatey_central_management_service_salt: servicesalt

## 3. ENSURE CHOCOLATEY IS INSTALLED ##
### Ensure Chocolatey is installed from your internal repository

  tasks:
  - name: Install chocolatey
    win_chocolatey:
      name: chocolatey
      source: ""{{ nuget_repository_url }}""
      # source_username: ""{{ nuget_repository_username }}""
      # source_password: ""{{ nuget_repository_password }}""

## 4. CONFIGURE CHOCOLATEY BASELINE ##
### a. FIPS Feature ###
#### If you need FIPS compliance - make this the first thing you configure
#### before you do any additional configuration or package installations
#   - name: Enable FIPS compliance
#     win_chocolatey_feature:
#       name: useFipsCompliantChecksums
#       state: enabled

### b. Apply Recommended Configuration ###

#### Move cache location so Chocolatey is very deterministic about
#### cleaning up temporary data and the location is secured to admins
  - name: Set the cache location
    win_chocolatey_config:
      name: cacheLocation
      state: present
      value: C:\ProgramData\chocolatey\cache

#### Increase timeout to at least 4 hours
  - name: Set the command execution timeout
    win_chocolatey_config:
      name: commandExecutionTimeoutSeconds
      state: present
      value: 14400

#### Turn off download progress when running choco through integrations
  - name: Disable showing download progress
    win_chocolatey_feature:
      name: showDownloadProgress
      state: disabled

### c. Sources ###
#### Remove the default community package repository source
  - name: Remove Chocolatey Community Repository
    win_chocolatey_source:
      name: chocolatey
      state: absent

#### Add internal default sources
#### You could have multiple sources here, so we will provide an example
#### of one using the remote repo variable here
#### NOTE: This EXAMPLE may require changes
  - name: Add Internal Repository
    win_chocolatey_source:
      name: ChocolateyInternal
      state: present
      source: {{ nuget_repository_url }}
      # source_username: {{ nuget_repository_username }}
      # source_password: {{ nuget_repository_password }}
      priority: 1

### b. Keep Chocolatey Up To Date ###
#### Keep chocolatey up to date based on your internal source
#### You control the upgrades based on when you push an updated version
####  to your internal repository.
#### Note the source here is to the OData feed, similar to what you see
####  when you browse to https://community.chocolatey.org/api/v2/
  - name: Upgrade Chocolatey
    win_chocolatey:
      name: chocolatey
      state: latest

## 5. ENSURE CHOCOLATEY FOR BUSINESS ##
### If you don't have Chocolatey for Business (C4B), you'll want to remove from here down.
### a. Ensure The License File Is Installed ###
#### Create a license package using script from https://docs.chocolatey.org/en-us/how-tos/setup-offline-installation#exercise-4-create-a-package-for-the-license
  - name: Install Chocolatey License
    win_chocolatey:
      name: chocolatey-license
      source: ChocolateyInternal
      state: latest

### b. Disable The Licensed Source ###
#### The licensed source cannot be removed, so it must be disabled.
#### This must occur after the license has been set by the license package.
  - name: Disable Chocolatey Community Repository
    win_chocolatey_source:
      name: chocolatey.licensed
      state: disabled

### c. Ensure Chocolatey Licensed Extension ###
#### You will have downloaded the licensed extension to your internal repository
#### as you have disabled the licensed repository in step 5b.

#### Ensure the chocolatey.extension package (aka Chocolatey Licensed Extension)
  - name: Install Chocolatey Extension
    win_chocolatey:
      name: chocolatey.extension
      source: ChocolateyInternal
      state: latest

#### The Chocolatey Licensed Extension unlocks all of the following, which also have configuration/feature items available with them. You may want to visit the feature pages to see what you might want to also enable:
#### - Package Builder - https://docs.chocolatey.org/en-us/features/paid/package-builder
#### - Package Internalizer - https://docs.chocolatey.org/en-us/features/paid/package-internalizer
#### - Package Synchronization (3 components) - https://docs.chocolatey.org/en-us/features/paid/package-synchronization
#### - Package Reducer - https://docs.chocolatey.org/en-us/features/paid/package-reducer
#### - Package Audit - https://docs.chocolatey.org/en-us/features/paid/package-audit
#### - Package Throttle - https://docs.chocolatey.org/en-us/features/paid/package-throttle
#### - CDN Cache Access - https://docs.chocolatey.org/en-us/features/paid/private-cdn
#### - Branding - https://docs.chocolatey.org/en-us/features/paid/branding
#### - Self-Service Anywhere (more components will need to be installed and additional configuration will need to be set) - https://docs.chocolatey.org/en-us/features/paid/self-service-anywhere
#### - Chocolatey Central Management (more components will need to be installed and additional configuration will need to be set) - https://docs.chocolatey.org/en-us/features/paid/chocolatey-central-management
#### - Other - https://docs.chocolatey.org/en-us/features/paid/

### d. Ensure Self-Service Anywhere ###
#### If you have desktop clients where users are not administrators, you may
#### to take advantage of deploying and configuring Self-Service anywhere
  - name: Hide not-elevated warnings
    win_chocolatey_feature:
      name: showNonElevatedWarnings
      state: disabled

  - name: Use background mode for self-service
    win_chocolatey_feature:
      name: useBackgroundService
      state: enabled

  - name: Use background service for non-admins
    win_chocolatey_feature:
      name: useBackgroundServiceWithNonAdministratorsOnly
      state: enabled

  - name: Allow background uninstallation for user installs
    win_chocolatey_feature:
      name: allowBackgroundServiceUninstallsFromUserInstallsOnly
      state: enabled

  - name: Set allowed background service commands
    win_chocolatey_config:
      name: backgroundServiceAllowedCommands
      state: present
      value: install,upgrade,uninstall

### e. Ensure Chocolatey Central Management ###
#### If you want to manage and report on endpoints, you can set up and configure
### Central Management. There are multiple portions to manage, so you'll see
### a section on agents here along with notes on how to configure the server
### side components.
  - name: Install Chocolatey Agent
    when: chocolatey_central_management_url is defined
    win_chocolatey:
      name: chocolatey-agent
      source: ChocolateyInternal
      state: latest

  - name: Set the Central Management Service URL
    when: chocolatey_central_management_url is defined
    win_chocolatey_config:
      name: CentralManagementServiceUrl
      state: present
      value: {{ chocolatey_central_management_url }}

  - name: Set the Central Management Client Salt
    when: chocolatey_central_management_client_salt is defined
    win_chocolatey_config:
      name: centralManagementClientCommunicationSaltAdditivePassword
      state: present
      value: {{ chocolatey_central_management_client_salt }}

  - name: Set the Central Management Service Salt
    when: chocolatey_central_management_service_salt is defined
    win_chocolatey_config:
      name: centralManagementServiceCommunicationSaltAdditivePassword
      state: present
      value: {{ chocolatey_central_management_service_salt }}

  - name: Use Central Management
    when: chocolatey_central_management_url is defined
    win_chocolatey_feature:
      name: useChocolateyCentralManagement
      state: enabled

  - name: Use Central Management Deployments
    when: chocolatey_central_management_url is defined
    win_chocolatey_feature:
      name: useChocolateyCentralManagementDeployments
      state: enabled

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

If Applicable - Chocolatey Configuration/Installation


## 1. REQUIREMENTS ##
### Here are the requirements necessary to ensure this is successful.

### a. Internal/Private Cloud Repository Set Up ###
#### You'll need an internal/private cloud repository you can use. These are
####  generally really quick to set up and there are quite a few options.
####  Chocolatey Software recommends Nexus, Artifactory Pro, or ProGet as they
####  are repository servers and will give you the ability to manage multiple
####  repositories and types from one server installation.

### b. Download Chocolatey Package and Put on Internal Repository ###
#### You need to have downloaded the Chocolatey package as well.
####  Please see https://chocolatey.org/install#organization

### c. Other Requirements ###
#### The Chocolatey resources are available with any recent version of Chef.
#### We utilise the Chocolatey recipe to install the Chocolatey binaries.
include_recipe "chocolatey"

## 2. TOP LEVEL VARIABLES ##
### a. Your internal repository url (the main one). ###
####  Should be similar to what you see when you browse
#### to https://community.chocolatey.org/api/v2/
NugetRepositoryUrl = "INTERNAL REPO URL"

### b. Internal Repository Credential ###
#### If required, add the repository access credential here
# NugetRepositoryUsername = "username"
# NugetRepositoryPassword = "password"

### c. Chocolatey nupkg download url ###
#### This url should result in an immediate download when you navigate to it in
#### a web browser
ChocolateyNupkgUrl = "INTERNAL REPO URL/package/chocolatey.2.2.2.nupkg",

### d. Chocolatey Central Management (CCM) ###
#### If using CCM to manage Chocolatey, add the following:
#### i. Endpoint URL for CCM
# ChocolateyCentralManagementUrl = "https://chocolatey-central-management:24020/ChocolateyManagementService"

#### ii. If using a Client Salt, add it here
# ChocolateyCentralManagementClientSalt = "clientsalt"

#### iii. If using a Service Salt, add it here
# ChocolateyCentralManagementServiceSalt = "servicesalt"

## 3. ENSURE CHOCOLATEY IS INSTALLED ##
### Ensure Chocolatey is installed from your internal repository
node['chocolatey']['install vars'] = {
  'chocolateyDownloadUrl' => "#{ChocolateyNupkgUrl}",
}

## 4. CONFIGURE CHOCOLATEY BASELINE ##
### a. FIPS Feature ###
#### If you need FIPS compliance - make this the first thing you configure
#### before you do any additional configuration or package installations
# chocolatey_feature 'useFipsCompliantChecksums' do
#   action :enable
# end

### b. Apply Recommended Configuration ###

#### Move cache location so Chocolatey is very deterministic about
#### cleaning up temporary data and the location is secured to admins
chocolatey_config 'cacheLocation' do
  value 'C:\ProgramData\chocolatey\cache'
end

#### Increase timeout to at least 4 hours
chocolatey_config 'commandExecutionTimeoutSeconds' do
  value '14400'
end

#### Turn off download progress when running choco through integrations
chocolatey_feature 'showDownloadProgress' do
  action :disable
end

### c. Sources ###
#### Remove the default community package repository source
chocolatey_source 'chocolatey' do
  action :remove
end

#### Add internal default sources
#### You could have multiple sources here, so we will provide an example
#### of one using the remote repo variable here

#### NOTE: This EXAMPLE may require changes
chocolatey_source 'ChocolateyInternal' do
  source "#{NugetRepositoryUrl}"
  priority 1
  action   :add
end

execute 'ChocolateyInternal' do
  command "choco source add --name ChocolateyInternal -s #{NugetRepositoryUrl} -u=#{NugetRepositoryUsername} -p=#{NugetRepositoryPassword} --priority=1"
  only_if { NugetRepositoryUsername != nil || NugetRepositoryPassword != nil }
end

### b. Keep Chocolatey Up To Date ###
#### Keep chocolatey up to date based on your internal source
#### You control the upgrades based on when you push an updated version
####  to your internal repository.
#### Note the source here is to the OData feed, similar to what you see
####  when you browse to https://community.chocolatey.org/api/v2/
chocolatey_package 'chocolatey' do
  action :upgrade
  source "#{NugetRepositoryUrl}"
end

## 5. ENSURE CHOCOLATEY FOR BUSINESS ##
### If you don't have Chocolatey for Business (C4B), you'll want to remove from here down.

### a. Ensure The License File Is Installed ###
#### Create a license package using script from https://docs.chocolatey.org/en-us/how-tos/setup-offline-installation#exercise-4-create-a-package-for-the-license
chocolatey_package 'chocolatey-license' do
  action :install
  source "#{NugetRepositoryUrl}"
end

### b. Disable The Licensed Source ###
#### The licensed source cannot be removed, so it must be disabled.
#### This must occur after the license has been set by the license package.
chocolatey_source 'chocolatey.licensed' do
  action            :disable
end

### c. Ensure Chocolatey Licensed Extension ###
#### You will have downloaded the licensed extension to your internal repository
#### as you have disabled the licensed repository in step 5b.

#### Ensure the chocolatey.extension package (aka Chocolatey Licensed Extension)
chocolatey_package 'chocolatey.extention' do
  action     install
  source     "#{NugetRepositoryUrl}"
end

#### The Chocolatey Licensed Extension unlocks all of the following, which also have configuration/feature items available with them. You may want to visit the feature pages to see what you might want to also enable:
#### - Package Builder - https://docs.chocolatey.org/en-us/features/paid/package-builder
#### - Package Internalizer - https://docs.chocolatey.org/en-us/features/paid/package-internalizer
#### - Package Synchronization (3 components) - https://docs.chocolatey.org/en-us/features/paid/package-synchronization
#### - Package Reducer - https://docs.chocolatey.org/en-us/features/paid/package-reducer
#### - Package Audit - https://docs.chocolatey.org/en-us/features/paid/package-audit
#### - Package Throttle - https://docs.chocolatey.org/en-us/features/paid/package-throttle
#### - CDN Cache Access - https://docs.chocolatey.org/en-us/features/paid/private-cdn
#### - Branding - https://docs.chocolatey.org/en-us/features/paid/branding
#### - Self-Service Anywhere (more components will need to be installed and additional configuration will need to be set) - https://docs.chocolatey.org/en-us/features/paid/self-service-anywhere
#### - Chocolatey Central Management (more components will need to be installed and additional configuration will need to be set) - https://docs.chocolatey.org/en-us/features/paid/chocolatey-central-management
#### - Other - https://docs.chocolatey.org/en-us/features/paid/

### d. Ensure Self-Service Anywhere ###
#### If you have desktop clients where users are not administrators, you may
#### to take advantage of deploying and configuring Self-Service anywhere
chocolatey_feature 'showNonElevatedWarnings' do
  action :disable
end

chocolatey_feature 'useBackgroundService' do
  action :enable
end

chocolatey_feature 'useBackgroundServiceWithNonAdministratorsOnly' do
  action :enable
end

chocolatey_feature 'allowBackgroundServiceUninstallsFromUserInstallsOnly' do
  action :enable
end

chocolatey_config 'backgroundServiceAllowedCommands' do
  value 'install,upgrade,uninstall'
end

### e. Ensure Chocolatey Central Management ###
#### If you want to manage and report on endpoints, you can set up and configure
### Central Management. There are multiple portions to manage, so you'll see
### a section on agents here along with notes on how to configure the server
### side components.
chocolatey_package 'chocolatey-agent' do
  action     install
  source     "#{NugetRepositoryUrl}"
  # user       "#{NugetRepositoryUsername}"
  # password   "#{NugetRepositoryPassword}"
  only_if { ChocolateyCentralManagementUrl != nil }
end

chocolatey_config 'CentralManagementServiceUrl' do
  value  "#{ChocolateyCentralManagementUrl}"
  only_if { ChocolateyCentralManagementUrl != nil }
end

chocolatey_config 'centralManagementClientCommunicationSaltAdditivePassword' do
  value   "#{ChocolateyCentralManagementClientSalt}"
  only_if { ChocolateyCentralManagementClientSalt != nil }
end

chocolatey_config 'centralManagementServiceCommunicationSaltAdditivePassword' do
  value   "#{ChocolateyCentralManagementServiceSalt}"
  only_if { ChocolateyCentralManagementServiceSalt != nil }
end

chocolatey_feature 'useChocolateyCentralManagement' do
  action :enable
  only_if { ChocolateyCentralManagementUrl != nil }
end

chocolatey_feature 'useChocolateyCentralManagementDeployments' do
  action :enable
  only_if { ChocolateyCentralManagementUrl != nil }
end

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

If Applicable - Chocolatey Configuration/Installation


#requires -Modules cChoco
## 1. REQUIREMENTS ##
### Here are the requirements necessary to ensure this is successful.

### a. Internal/Private Cloud Repository Set Up ###
#### You'll need an internal/private cloud repository you can use. These are
####  generally really quick to set up and there are quite a few options.
####  Chocolatey Software recommends Nexus, Artifactory Pro, or ProGet as they
####  are repository servers and will give you the ability to manage multiple
####  repositories and types from one server installation.

### b. Download Chocolatey Package and Put on Internal Repository ###
#### You need to have downloaded the Chocolatey package as well.
####  Please see https://chocolatey.org/install#organization

### c. Other Requirements ###
#### i. Requires chocolatey\cChoco DSC module to be installed on the machine compiling the DSC manifest
#### NOTE: This will need to be installed before running the DSC portion of this script
if (-not (Get-Module cChoco -ListAvailable)) {
    $null = Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force
    if (($PSGallery = Get-PSRepository -Name PSGallery).InstallationPolicy -ne "Trusted") {
        Set-PSRepository -Name PSGallery -InstallationPolicy Trusted
    }
    Install-Module -Name cChoco
    if ($PSGallery.InstallationPolicy -ne "Trusted") {
        Set-PSRepository -Name PSGallery -InstallationPolicy $PSGallery.InstallationPolicy
    }
}

#### ii. Requires a hosted copy of the install.ps1 script
##### This should be available to download without authentication.
##### The original script can be found here: https://community.chocolatey.org/install.ps1

Configuration ChocolateyConfig {
## 2. TOP LEVEL VARIABLES ##
    param(
### a. Your internal repository url (the main one). ###
####  Should be similar to what you see when you browse
#### to https://community.chocolatey.org/api/v2/
        $NugetRepositoryUrl      = "INTERNAL REPO URL",

### b. Chocolatey nupkg download url ###
#### This url should result in an immediate download when you navigate to it in
#### a web browser
        $ChocolateyNupkgUrl      = "INTERNAL REPO URL/package/chocolatey.2.2.2.nupkg",

### c. Internal Repository Credential ###
#### If required, add the repository access credential here
#        $NugetRepositoryCredential = [PSCredential]::new(
#            "username",
#            ("password" | ConvertTo-SecureString -AsPlainText -Force)
#        ),

### d. Install.ps1 URL
#### The path to the hosted install script:
        $ChocolateyInstallPs1Url = "https://community.chocolatey.org/install.ps1"

### e. Chocolatey Central Management (CCM) ###
#### If using CCM to manage Chocolatey, add the following:
#### i. Endpoint URL for CCM
#        $ChocolateyCentralManagementUrl = "https://chocolatey-central-management:24020/ChocolateyManagementService",

#### ii. If using a Client Salt, add it here
#        $ChocolateyCentralManagementClientSalt = "clientsalt",

#### iii. If using a Service Salt, add it here
#        $ChocolateyCentralManagementServiceSalt = "servicesalt"
    )
    Import-DscResource -ModuleName PSDesiredStateConfiguration
    Import-DscResource -ModuleName cChoco

    Node 'localhost' {
## 3. ENSURE CHOCOLATEY IS INSTALLED ##
### Ensure Chocolatey is installed from your internal repository
        Environment chocoDownloadUrl {
            Name  = "chocolateyDownloadUrl"
            Value = $ChocolateyNupkgUrl
        }

        cChocoInstaller installChocolatey {
            DependsOn = "[Environment]chocoDownloadUrl"
            InstallDir = Join-Path $env:ProgramData "chocolatey"
            ChocoInstallScriptUrl = $ChocolateyInstallPs1Url
        }

## 4. CONFIGURE CHOCOLATEY BASELINE ##
### a. FIPS Feature ###
#### If you need FIPS compliance - make this the first thing you configure
#### before you do any additional configuration or package installations
#        cChocoFeature featureFipsCompliance {
#            FeatureName = "useFipsCompliantChecksums"
#        }

### b. Apply Recommended Configuration ###

#### Move cache location so Chocolatey is very deterministic about
#### cleaning up temporary data and the location is secured to admins
        cChocoConfig cacheLocation {
            DependsOn  = "[cChocoInstaller]installChocolatey"
            ConfigName = "cacheLocation"
            Value      = "C:\ProgramData\chocolatey\cache"
        }

#### Increase timeout to at least 4 hours
        cChocoConfig commandExecutionTimeoutSeconds {
            DependsOn  = "[cChocoInstaller]installChocolatey"
            ConfigName = "commandExecutionTimeoutSeconds"
            Value      = 14400
        }

#### Turn off download progress when running choco through integrations
        cChocoFeature showDownloadProgress {
            DependsOn   = "[cChocoInstaller]installChocolatey"
            FeatureName = "showDownloadProgress"
            Ensure      = "Absent"
        }

### c. Sources ###
#### Remove the default community package repository source
        cChocoSource removeCommunityRepository {
            DependsOn  = "[cChocoInstaller]installChocolatey"
            Name       = "chocolatey"
            Ensure     = "Absent"
        }

#### Add internal default sources
#### You could have multiple sources here, so we will provide an example
#### of one using the remote repo variable here.
#### NOTE: This EXAMPLE may require changes
        cChocoSource addInternalSource {
            DependsOn  = "[cChocoInstaller]installChocolatey"
            Name        = "ChocolateyInternal"
            Source      = $NugetRepositoryUrl
            Credentials = $NugetRepositoryCredential
            Priority    = 1
        }

### b. Keep Chocolatey Up To Date ###
#### Keep chocolatey up to date based on your internal source
#### You control the upgrades based on when you push an updated version
####  to your internal repository.
#### Note the source here is to the OData feed, similar to what you see
####  when you browse to https://community.chocolatey.org/api/v2/
        cChocoPackageInstaller updateChocolatey {
            DependsOn   = "[cChocoSource]addInternalSource", "[cChocoSource]removeCommunityRepository"
            Name        = "chocolatey"
            AutoUpgrade = $true
        }

## 5. ENSURE CHOCOLATEY FOR BUSINESS ##
### If you don't have Chocolatey for Business (C4B), you'll want to remove from here down.

### a. Ensure The License File Is Installed ###
#### Create a license package using script from https://docs.chocolatey.org/en-us/how-tos/setup-offline-installation#exercise-4-create-a-package-for-the-license
        cChocoPackageInstaller chocolateyLicense {
            DependsOn = "[cChocoPackageInstaller]updateChocolatey"
            Name      = "chocolatey-license"
        }

### b. Disable The Licensed Source ###
#### The licensed source cannot be removed, so it must be disabled.
#### This must occur after the license has been set by the license package.
        Script disableLicensedSource {
            DependsOn  = "[cChocoPackageInstaller]chocolateyLicense"
            GetScript  = {
                $Source = choco source list --limitoutput | `
                    ConvertFrom-Csv -Delimiter '|' -Header Name, Source, Disabled | `
                    Where-Object Name -eq "chocolatey.licensed"

                return @{
                    Result = if ($Source) {
                        [bool]::Parse($Source.Disabled)
                    } else {
                        Write-Warning "Source 'chocolatey.licensed' was not present."
                        $true  # Source does not need disabling
                    }
                }
            }
            SetScript  = {
                $null = choco source disable --name "chocolatey.licensed"
            }
            TestScript = {
                $State = [ScriptBlock]::Create($GetScript).Invoke()
                return $State.Result
            }
        }

### c. Ensure Chocolatey Licensed Extension ###
#### You will have downloaded the licensed extension to your internal repository
#### as you have disabled the licensed repository in step 5b.

#### Ensure the chocolatey.extension package (aka Chocolatey Licensed Extension)
        cChocoPackageInstaller chocolateyLicensedExtension {
            DependsOn = "[Script]disableLicensedSource"
            Name      = "chocolatey.extension"
        }

#### The Chocolatey Licensed Extension unlocks all of the following, which also have configuration/feature items available with them. You may want to visit the feature pages to see what you might want to also enable:
#### - Package Builder - https://docs.chocolatey.org/en-us/features/paid/package-builder
#### - Package Internalizer - https://docs.chocolatey.org/en-us/features/paid/package-internalizer
#### - Package Synchronization (3 components) - https://docs.chocolatey.org/en-us/features/paid/package-synchronization
#### - Package Reducer - https://docs.chocolatey.org/en-us/features/paid/package-reducer
#### - Package Audit - https://docs.chocolatey.org/en-us/features/paid/package-audit
#### - Package Throttle - https://docs.chocolatey.org/en-us/features/paid/package-throttle
#### - CDN Cache Access - https://docs.chocolatey.org/en-us/features/paid/private-cdn
#### - Branding - https://docs.chocolatey.org/en-us/features/paid/branding
#### - Self-Service Anywhere (more components will need to be installed and additional configuration will need to be set) - https://docs.chocolatey.org/en-us/features/paid/self-service-anywhere
#### - Chocolatey Central Management (more components will need to be installed and additional configuration will need to be set) - https://docs.chocolatey.org/en-us/features/paid/chocolatey-central-management
#### - Other - https://docs.chocolatey.org/en-us/features/paid/

### d. Ensure Self-Service Anywhere ###
#### If you have desktop clients where users are not administrators, you may
#### to take advantage of deploying and configuring Self-Service anywhere
        cChocoFeature hideElevatedWarnings {
            DependsOn   = "[cChocoPackageInstaller]chocolateyLicensedExtension"
            FeatureName = "showNonElevatedWarnings"
            Ensure      = "Absent"
        }

        cChocoFeature useBackgroundService {
            DependsOn   = "[cChocoPackageInstaller]chocolateyLicensedExtension"
            FeatureName = "useBackgroundService"
            Ensure      = "Present"
        }

        cChocoFeature useBackgroundServiceWithNonAdmins {
            DependsOn   = "[cChocoPackageInstaller]chocolateyLicensedExtension"
            FeatureName = "useBackgroundServiceWithNonAdministratorsOnly"
            Ensure      = "Present"
        }

        cChocoFeature useBackgroundServiceUninstallsForUserInstalls {
            DependsOn   = "[cChocoPackageInstaller]chocolateyLicensedExtension"
            FeatureName = "allowBackgroundServiceUninstallsFromUserInstallsOnly"
            Ensure      = "Present"
        }

        cChocoConfig allowedBackgroundServiceCommands {
            DependsOn   = "[cChocoFeature]useBackgroundService"
            ConfigName = "backgroundServiceAllowedCommands"
            Value       = "install,upgrade,uninstall"
        }

### e. Ensure Chocolatey Central Management ###
#### If you want to manage and report on endpoints, you can set up and configure
### Central Management. There are multiple portions to manage, so you'll see
### a section on agents here along with notes on how to configure the server
### side components.
        if ($ChocolateyCentralManagementUrl) {
            cChocoPackageInstaller chocolateyAgent {
                DependsOn = "[cChocoPackageInstaller]chocolateyLicensedExtension"
                Name      = "chocolatey-agent"
            }

            cChocoConfig centralManagementServiceUrl {
                DependsOn   = "[cChocoPackageInstaller]chocolateyAgent"
                ConfigName = "CentralManagementServiceUrl"
                Value       = $ChocolateyCentralManagementUrl
            }

            if ($ChocolateyCentralManagementClientSalt) {
                cChocoConfig centralManagementClientSalt {
                    DependsOn  = "[cChocoPackageInstaller]chocolateyAgent"
                    ConfigName = "centralManagementClientCommunicationSaltAdditivePassword"
                    Value      = $ChocolateyCentralManagementClientSalt
                }
            }

            if ($ChocolateyCentralManagementServiceSalt) {
                cChocoConfig centralManagementServiceSalt {
                    DependsOn  = "[cChocoPackageInstaller]chocolateyAgent"
                    ConfigName = "centralManagementServiceCommunicationSaltAdditivePassword"
                    Value      = $ChocolateyCentralManagementServiceSalt
                }
            }

            cChocoFeature useCentralManagement {
                DependsOn   = "[cChocoPackageInstaller]chocolateyAgent"
                FeatureName = "useChocolateyCentralManagement"
                Ensure      = "Present"
            }

            cChocoFeature useCentralManagementDeployments {
                DependsOn   = "[cChocoPackageInstaller]chocolateyAgent"
                FeatureName = "useChocolateyCentralManagementDeployments"
                Ensure      = "Present"
            }
        }
    }
}

# If working this into an existing configuration with a good method for
$ConfigData = @{
    AllNodes = @(
        @{
            NodeName                    = "localhost"
            PSDscAllowPlainTextPassword = $true
        }
    )
}

try {
    Push-Location $env:Temp
    $Config = ChocolateyConfig -ConfigurationData $ConfigData
    Start-DscConfiguration -Path $Config.PSParentPath -Wait -Verbose -Force
} finally {
    Pop-Location
}

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

If Applicable - Chocolatey Configuration/Installation


## 1. REQUIREMENTS ##
### Here are the requirements necessary to ensure this is successful.

### a. Internal/Private Cloud Repository Set Up ###
#### You'll need an internal/private cloud repository you can use. These are
####  generally really quick to set up and there are quite a few options.
####  Chocolatey Software recommends Nexus, Artifactory Pro, or ProGet as they
####  are repository servers and will give you the ability to manage multiple
####  repositories and types from one server installation.

### b. Download Chocolatey Package and Put on Internal Repository ###
#### You need to have downloaded the Chocolatey package as well.
####  Please see https://chocolatey.org/install#organization

### c. Other Requirements ###
#### i. Requires puppetlabs/chocolatey module
####  See https://forge.puppet.com/puppetlabs/chocolatey


## 2. TOP LEVEL VARIABLES ##
### a. Your internal repository url (the main one). ###
####  Should be similar to what you see when you browse
#### to https://community.chocolatey.org/api/v2/
$_repository_url = 'INTERNAL REPO URL'

### b. Chocolatey nupkg download url ###
#### This url should result in an immediate download when you navigate to it in
#### a web browser
$_choco_download_url = 'INTERNAL REPO URL/package/chocolatey.2.2.2.nupkg'

### c. Chocolatey Central Management (CCM) ###
#### If using CCM to manage Chocolatey, add the following:
#### i. Endpoint URL for CCM
# $_chocolatey_central_management_url = 'https://chocolatey-central-management:24020/ChocolateyManagementService'

#### ii. If using a Client Salt, add it here
# $_chocolatey_central_management_client_salt = "clientsalt"

#### iii. If using a Service Salt, add it here
# $_chocolatey_central_management_service_salt = 'servicesalt'


## 3. ENSURE CHOCOLATEY IS INSTALLED ##
### Ensure Chocolatey is installed from your internal repository
### Note: `chocolatey_download_url is completely different than normal
###  source locations. This is directly to the bare download url for the
###  chocolatey.nupkg, similar to what you see when you browse to
###  https://community.chocolatey.org/api/v2/package/chocolatey
class {'chocolatey':
  chocolatey_download_url => $_choco_download_url,
  use_7zip                => false,
}


## 4. CONFIGURE CHOCOLATEY BASELINE ##
### a. FIPS Feature ###
#### If you need FIPS compliance - make this the first thing you configure
#### before you do any additional configuration or package installations

#chocolateyfeature {'useFipsCompliantChecksums':
#  ensure => enabled,
#}

### b. Apply Recommended Configuration ###

#### Move cache location so Chocolatey is very deterministic about
#### cleaning up temporary data and the location is secured to admins
chocolateyconfig {'cacheLocation':
  value => 'C:\ProgramData\chocolatey\cache',
}

#### Increase timeout to at least 4 hours
chocolateyconfig {'commandExecutionTimeoutSeconds':
  value => '14400',
}

#### Turn off download progress when running choco through integrations
chocolateyfeature {'showDownloadProgress':
  ensure => disabled,
}

### c. Sources ###
#### Remove the default community package repository source
chocolateysource {'chocolatey':
  ensure   => absent,
  location => 'https://community.chocolatey.org/api/v2/',
}

#### Add internal default sources
#### You could have multiple sources here, so we will provide an example
#### of one using the remote repo variable here

#### NOTE: This EXAMPLE requires changes
chocolateysource {'internal_chocolatey':
  ensure             => present,
  location           => $_repository_url,
  priority           => 1,
  username           => 'optional',
  password           => 'optional,not ensured',
  bypass_proxy       => true,
  admin_only         => false,
  allow_self_service => false,
}

### b. Keep Chocolatey Up To Date ###
#### Keep chocolatey up to date based on your internal source
#### You control the upgrades based on when you push an updated version
####  to your internal repository.
#### Note the source here is to the OData feed, similar to what you see
####  when you browse to https://community.chocolatey.org/api/v2/

package {'chocolatey':
  ensure   => latest,
  provider => chocolatey,
  source   => $_repository_url,
}


## 5. ENSURE CHOCOLATEY FOR BUSINESS ##
### If you don't have Chocolatey for Business (C4B), you'll want to remove from here down.

### a. Ensure The License File Is Installed ###
#### Create a license package using script from https://docs.chocolatey.org/en-us/guides/organizations/organizational-deployment-guide#exercise-4-create-a-package-for-the-license

# TODO: Add resource for installing/ensuring the chocolatey-license package
package {'chocolatey-license':
  ensure   => latest,
  provider => chocolatey,
  source   => $_repository_url,
}

### b. Disable The Licensed Source ###
#### The licensed source cannot be removed, so it must be disabled.
#### This must occur after the license has been set by the license package.
## Disabled sources still need all other attributes until
## https://tickets.puppetlabs.com/browse/MODULES-4449 is resolved.
## Password is necessary with user, but not ensurable, so it should not
## matter what it is set to here. If you ever do get into trouble here,
## the password is your license GUID.
chocolateysource {'chocolatey.licensed':
  ensure   => disabled,
  priority => '10',
  user     => 'customer',
  password => '1234',
  require  => Package['chocolatey-license'],
}

### c. Ensure Chocolatey Licensed Extension ###
#### You will have downloaded the licensed extension to your internal repository
#### as you have disabled the licensed repository in step 5b.

#### Ensure the chocolatey.extension package (aka Chocolatey Licensed Extension)
package {'chocolatey.extension':
  ensure   => latest,
  provider => chocolatey,
  source   => $_repository_url,
  require  => Package['chocolatey-license'],
}

#### The Chocolatey Licensed Extension unlocks all of the following, which also have configuration/feature items available with them. You may want to visit the feature pages to see what you might want to also enable:
#### - Package Builder - https://docs.chocolatey.org/en-us/features/paid/package-builder
#### - Package Internalizer - https://docs.chocolatey.org/en-us/features/paid/package-internalizer
#### - Package Synchronization (3 components) - https://docs.chocolatey.org/en-us/features/paid/package-synchronization
#### - Package Reducer - https://docs.chocolatey.org/en-us/features/paid/package-reducer
#### - Package Audit - https://docs.chocolatey.org/en-us/features/paid/package-audit
#### - Package Throttle - https://docs.chocolatey.org/en-us/features/paid/package-throttle
#### - CDN Cache Access - https://docs.chocolatey.org/en-us/features/paid/private-cdn
#### - Branding - https://docs.chocolatey.org/en-us/features/paid/branding
#### - Self-Service Anywhere (more components will need to be installed and additional configuration will need to be set) - https://docs.chocolatey.org/en-us/features/paid/self-service-anywhere
#### - Chocolatey Central Management (more components will need to be installed and additional configuration will need to be set) - https://docs.chocolatey.org/en-us/features/paid/chocolatey-central-management
#### - Other - https://docs.chocolatey.org/en-us/features/paid/

### d. Ensure Self-Service Anywhere ###
#### If you have desktop clients where users are not administrators, you may
#### to take advantage of deploying and configuring Self-Service anywhere
chocolateyfeature {'showNonElevatedWarnings':
  ensure => disabled,
}

chocolateyfeature {'useBackgroundService':
  ensure => enabled,
}

chocolateyfeature {'useBackgroundServiceWithNonAdministratorsOnly':
  ensure => enabled,
}

chocolateyfeature {'allowBackgroundServiceUninstallsFromUserInstallsOnly':
  ensure => enabled,
}

chocolateyconfig {'backgroundServiceAllowedCommands':
  value => 'install,upgrade,uninstall',
}

### e. Ensure Chocolatey Central Management ###
#### If you want to manage and report on endpoints, you can set up and configure
### Central Management. There are multiple portions to manage, so you'll see
### a section on agents here along with notes on how to configure the server
### side components.
if $_chocolatey_central_management_url {
  package {'chocolatey-agent':
    ensure   => latest,
    provider => chocolatey,
    source   => $_repository_url,
    require  => Package['chocolatey-license'],
  }

  chocolateyconfig {'CentralManagementServiceUrl':
    value   => $_chocolatey_central_management_url,
  }

  if $_chocolatey_central_management_client_salt {
    chocolateyconfig {'centralManagementClientCommunicationSaltAdditivePassword':
      value => $_chocolatey_central_management_client_salt,
    }
  }

  if $_chocolatey_central_management_service_salt {
    chocolateyconfig {'centralManagementClientCommunicationSaltAdditivePassword':
      value => $_chocolatey_central_management_client_salt,
    }
  }

  chocolateyfeature {'useChocolateyCentralManagement':
    ensure  => enabled,
    require => Package['chocolatey-agent'],
  }

  chocolateyfeature {'useChocolateyCentralManagementDeployments':
    ensure  => enabled,
    require => Package['chocolatey-agent'],
  }
}

Need Help? View our docs or file an issue.

There is already a version of this package in your Script Builder

Current Version	New Version

Downloads:

931

Downloads of v 1.82:

51

Last Update:

14 Dec 2023

Package Maintainer(s):

TheCakeIsNaOH

Software Author(s):

Ilya Morozov

Tags:

balabolka balcon tts text-to-speech

Balabolka Console (balcon)

1.82 | Updated: 14 Dec 2023

Downloads:

931

Downloads of v 1.82:

Maintainer(s):

TheCakeIsNaOH

Software Author(s):

Ilya Morozov

Tags:

balabolka balcon tts text-to-speech

Balabolka Console (balcon) 1.82

Some Checks Have Failed or Are Not Yet Complete

Not All Tests Have Passed

Hide Checks

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

Learn More

Deployment Method: Individual Install, Upgrade, & Uninstall

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. Enter Your Internal Repository Url

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

2. Setup Your Environment

1. Ensure you are set for organizational deployment

Please see the organizational deployment guide

2. Get the package into your environment

Option 1: Cached Package (Unreliable, Requires Internet - Same As Community)

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

Option 2: Internalized Package (Reliable, Scalable)

Open Source
- Download the package:
  Download
- Follow manual internalization instructions

Package Internalizer (C4B)

Run: (additional options)

choco download balcon --internalize --source=https://community.chocolatey.org/api/v2/

For package and dependencies run:

choco push --source="'INTERNAL REPO URL'"

Automate package internalization

3. Copy Your Script

choco upgrade balcon -y --source="'INTERNAL REPO 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="'INTERNAL REPO URL'" 
$exitCode = $LASTEXITCODE

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

Exit $exitCode


- name: Install balcon
  win_chocolatey:
    name: balcon
    version: '1.82'
    source: INTERNAL REPO URL
    state: present

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


chocolatey_package 'balcon' do
  action    :install
  source   'INTERNAL REPO URL'
  version  '1.82'
end

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


cChocoPackageInstaller balcon
{
    Name     = "balcon"
    Version  = "1.82"
    Source   = "INTERNAL REPO URL"
}

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


package { 'balcon':
  ensure   => '1.82',
  provider => 'chocolatey',
  source   => 'INTERNAL REPO URL',
}

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

4. If applicable - Chocolatey configuration/installation

See infrastructure management matrix for Chocolatey configuration elements and examples.

Package Approved

This package was approved as a trusted package on 15 Dec 2023.

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.

Files

tools\balcon.exe

md5: 7F4C5E05A8E37DE69A4DD0B861245DAC | sha1: 8AB7C4635591B99B15DB815FA6E17FBFB44506AC | sha256: 2EC1945187EEB07AA27052DB2E60139BBEB3BF81F8BA549C4A2360363AB4338E | sha512: F026DFBE8CEC0DD1DBB4E464C40017911EC25EC89521D969A4870777FD59F9681B4D04DA247430D291DDB1C376AAB5A5784493AF916D8D98EAAFF8B3F9983459

tools\history.txt

Balabolka (Command Line Utility)
Copyright (c) 2013-2023 Ilya Morozov
All Rights Reserved


*** History ***

2023-12-13     v1.82
[+] Added the option to set the configuration file name.


2023-08-06     v1.81
[+] Added the option to display progress information in a console window.
[*] Fixed the using of SAPI 4 for foreign languages.


2022-05-20     v1.80
[-] Fixed reading data from STDIN.


2022-03-12     v1.79
[-] Fixed small bugs.


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.82
Авторски права (c) 2013-2023 Илия Морозов
Всички права запазени

Уебсайт: https://www.cross-plus-a.com/bg/bconsole.htm
Е-поща: [email protected]

Лиценз: Безплатен (Freeware)
Операционни системи: Microsoft Windows XP/Vista/7/8/10/11
Речев ППИ: 4.0/5.0
Microsoft Speech Platform: 11.0



*** Синтаксис ***

balcon [опции ...]


*** Опции на командния ред ***

-l
   Извежда на екрана списъка с наличните гласове.

-g
   Извежда на екрана списъка с налични звукови устройства.

-f <текстов_файл>
   Задава името на входния текстов файл. Командния ред може да съдържа повече от една [-f] опция.

-fl <име_на_файл>
   Задава името на текстовия файл със списъка от входни файлове (по едно име на файл на ред). Командния ред може да съдържа повече от една [-fl] опция.

-w <звуков_файл>
   Задава името на изходния файл в WAV формат. Ако опцията е зададена, ще бъде създаден аудио файл. Иначе, текста ще бъде прочетен на глас.

-n <име_на_гласа>
   Задава кой глас ще бъде използван (името на гласа е достатъчно). Ако опцията не е зададена, ще бъде използван гласа зададен по подразбиране в Windows.

-id <целочислена_стойност>
   Задава регионалния идентификатор (Language 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).
   Ако опцията не е указана, Ще се използва стойността по подразбиране за избрания глас.

-dp
   Display progress information in a console window.

-cfg <file_name>
   Sets the name of the configuration file with the command line options (a text file where each line contains one option). If the option is not specified, the file "balcon.cfg" in the same folder as the utility will be used.

-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, tk, 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.82
Copyright (c) 2013-2023 Ilya Morozov
All Rights Reserved

WWW: https://www.cross-plus-a.com/bconsole.htm
E-mail: [email protected]

Licence: Freeware
Operating System: Microsoft Windows XP/Vista/7/8/10/11
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 Language ID for the voice. Language 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 Language 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
   Gets the text input from the clipboard.

-t <text>
   Gets the text input from the command line. The command line may contain few options [-t].

-i
   Gets 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.

-dp
   Display progress information in a console window.

-cfg <file_name>
   Sets the name of the configuration file with the command line options (a text file where each line contains one option). If the option is not specified, the file "balcon.cfg" in the same folder as the utility will be used.

-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 speech rate 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, tk, 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, Nicaragua, North Korea, Syria, and the Crimea Region.

###

tools\readme.fin.txt

Balabolka (komentorivisovellus), versio 1.82
Copyright (c) 2013-2023 Ilya Morozov
All Rights Reserved

WWW: https://www.cross-plus-a.com/fi/bconsole.htm
E-mail: [email protected]

Lisenssi: Freeware
Käyttöjärestelmä: Microsoft Windows XP/Vista/7/8/10/11
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 (Language 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.

-dp
   Display progress information in a console window.

-cfg <file_name>
   Sets the name of the configuration file with the command line options (a text file where each line contains one option). If the option is not specified, the file "balcon.cfg" in the same folder as the utility will be used.

-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, tk, 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.82
Copyright (c) 2013-2023 Ilya Morozov
All Rights Reserved

WWW : https://www.cross-plus-a.com/fr/bconsole.htm
E-mail : [email protected]

Licence : Freeware
Système d'exploitation : Microsoft Windows XP/Vista/7/8/10/11
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>
   Ouvrir le fichier avec la liste des fichiers texte (un nom de fichier par ligne). 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 (Language ID). Language 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
   Mettre sur pause ou reprendre la lecture à voix haute par la copie de l’application en cours pour la console. L’action est la même que pour sélectionner un élément de menu "Pause"/"Reprendre".

-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 : créer un fichier texte avec des visèmes, si le paramètre [-w] est donné.
   Un visème est la forme de la bouche qui correspond à un son de parole particulier. SAPI supporte la liste de 21 visèmes.
   Cette liste est basée sur les visèmes originaux de Disney. L’application console créera un fichier audio, puis le lira à haute voix pour obtenir des visèmes et leurs codes temporels.
   La liste des visèmes supportés par 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 : sélectionner la fréquence d’échantillonnage audio de sortie en kHz (8, 11, 12, 16, 22, 24, 32, 44, 48).
   Si le paramètre n’est pas spécifié, la valeur par défaut de la voix sélectionnée sera utilisée.

-bt <nombre_intégral>
   SAPI 4 : l’option n’est pas utilisée.
   SAPI 5 et Microsoft Speech Platform : définir la profondeur de bits audio de sortie (8 ou 16).
   Si le paramètre n’est pas spécifié, la valeur par défaut de la voix sélectionnée sera utilisée.

-ch <nombre_intégral>
   SAPI 4 : l’option n’est pas utilisée.
   SAPI 5 et Microsoft Speech Platform : définir le mode du canal audio de sortie (1 ou 2).
   Si le paramètre n’est pas spécifié, la valeur par défaut de la voix sélectionnée sera utilisée.

-dp
   Afficher les informations sur l’avancement dans la fenêtre de console.

-cfg <file_name>
   Sets the name of the configuration file with the command line options (a text file where each line contains one option). If the option is not specified, the file "balcon.cfg" in the same folder as the utility will be used.

-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
   Insérer des lignes vides après les phrases dans le fichier LRC.

--lrc-para
   Insérer des lignes vides après les alinéas dans le fichier LRC.

--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
   Ignorer le texte entre [les crochets].

--ignore-curly-brackets ou -icb
   Ignorer le texte entre {les accolades}.

--ignore-angle-brackets ou -iab
   Ignorer le texte entre <les crochets angulaires>.

--ignore-round-brackets ou -irb
   Ignorer le texte entre (les parenthèses).

--ignore-url ou -iu
   Ignorer les adresses URL.

--ignore-comments ou -ic
   Ignorer les commentaires dans le texte. Les commentaires sur une seule ligne commencent par // et se poursuivent jusqu’à la fin de la ligne. Les commentaires multilignes commencent par /* et se terminent par */.

--voice1-name <nom_de_voix>
   SAPI 4 : l’option n’est pas utilisée.
   SAPI 5 et Microsoft Speech Platform : sélectionner une voix supplémentaire prévue pour lire des mots étrangers dans le corps du texte (il suffit d’indiquer une partie du nom de la voix). Le paramètre est utilisé conjointement avec le paramètre [--voice1-langid].
   Vous pouvez sélectionner plusieurs voix pour différentes langues à l’aide des paramètres [--voice2-name], [--voice3-name], etc.

--voice1-langid <identifiant_langue>
   Sélectionner un identifiant de langue pour la recherche des mots étrangers dans le texte. Le programme trouvera les lettres de la langue spécifiée dans le texte et ajoutera des balises de changement de voix pour lire ces caractères. Le paramètre est utilisé conjointement avec le paramètre [--voice1-name]. L’invite de commande peut contenir plusieurs paramètres [--voice1-langid]. On peut lister plusieurs identifiants, séparés par des virgules, au sein d’un même paramètre (par exemple : "fi,sv").
   La liste des identifiants de langue supportées par le programme (les codes des langues selon la norme ISO 639-1 sont utilisés) : 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, tk, tr, tt, uk, zh.

--voice1-rate <nombre_intégral>
   Définir le débit de parole pour la voix supplémentaire dans une plage de -10 à 10 (la valeur par défaut est 0).

--voice1-pitch <nombre_intégral>
   Régler la hauteur de la voix supplémentaire dans une plage de -10 à 10 (la valeur par défaut est 0).

--voice1-volume <nombre_intégral>
   Régler le volume de la voix supplémentaire dans une plage de 0 à 100 (la valeur par défaut est 100).

--voice1-roman
   Utiliser la voix par défaut pour lire les chiffres romains. Si une voix supplémentaire est définie pour la lecture des lettres latines, le programme ne changera pas de voix pour lire des chiffres romains.

--voice1-digit
   Utiliser la voix par défaut pour lire des nombres composés de chiffres arabes. Si le paramètre n’est pas défini, les nombres seront lus par la voix supplémentaire s’ils côtoient des mots étrangers.

--voice1-length <nombre_intégral>
   Définir la longueur minimale du texte étranger pour la lecture duquel le programme utilisera une voix supplémentaire (en caractères).


*** Exemples ***

Créer un fichier texte avec une liste des voix installées sur l’ordinateur :

balcon -l


Afficher les caractéristiques de la voix Microsoft Anna :

balcon -n "Microsoft Anna" -m


Convertir le fichier texte BOOK.TXT en fichier audio BOOK.WAV :

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


Récupérer le texte du presse-papiers, appliquer les règles des dictionnaires de correction de prononciation et lire à haute voix :

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


Lire le texte à partir de l’invite de commande à la vitesse et au volume spécifiés :

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


Arrêter les autres instances de l’application console :

balcon -k


Convertir le texte de STDIN en fichier audio BOOK.WAV et créer un fichier BOOK.LRC :

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


Convertir les sous-titres en fichier audio FILM.WAV :

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


Lire à haute voix des phrases en français et en russe par des voix différentes :

balcon -f "d:\Text\book.txt" -n Aurelie --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.82
Copyright (c) 2013-2023 Ilya Morozov
Alle Rechte vorbehalten

WWW: https://www.cross-plus-a.com/de/bconsole.htm
E-mail: [email protected] (nur rußisch oder englisch)

Lizenzart: Freeware
Plattformen: Microsoft Windows XP/Vista/7/8/10/11
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>
   Bestimmt den Namen der Textdatei mit der Liste der Eingabedateien (ein Dateiname pro Zeile). 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 "Language ID" für die Stimme. Die "Language 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 Language 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.

-dp
   Anzeige von Fortschrittsinformationen in einem Konsolenfenster.

-cfg <file_name>
   Sets the name of the configuration file with the command line options (a text file where each line contains one option). If the option is not specified, the file "balcon.cfg" in the same folder as the utility will be used.

-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, tk, 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.82
Copyright (c) 2013-2023 Ilya Morozov
Wszystkie prawa zastrzeżone

WWW: https://www.cross-plus-a.com/pl/bconsole.htm
E-mail: [email protected]

Licenzja: Freeware
System operacyjny: Microsoft Windows XP/Vista/7/8/10/11
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 (Language 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.

-dp
   Display progress information in a console window.

-cfg <file_name>
   Sets the name of the configuration file with the command line options (a text file where each line contains one option). If the option is not specified, the file "balcon.cfg" in the same folder as the utility will be used.

-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, tk, 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.82
Copyright (c) 2013-2023 Ilya Morozov
All Rights Reserved

WWW: https://www.cross-plus-a.com/br/bconsole.htm
E-mail: [email protected]

Licen�a: Freeware
Sistema operacional: Microsoft Windows XP/Vista/7/8/10/11
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 (Language 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.

-dp
   Display progress information in a console window.

-cfg <file_name>
   Sets the name of the configuration file with the command line options (a text file where each line contains one option). If the option is not specified, the file "balcon.cfg" in the same folder as the utility will be used.

-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, tk, 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.82
Copyright (с) 2013-2023 Илья Морозов
Все права защищены

WWW: https://www.cross-plus-a.com/ru/bconsole.html
E-mail: [email protected]

Тип лицензии: Freeware
Операционная система: Microsoft Windows XP/Vista/7/8/10/11
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 <число>
   Выбрать голос при помощи идентификатора языка (Language 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).
   Если параметр не задан, используется значение по умолчанию для выбранного голоса.

-dp
   Показать индикатор прогресса выполнения в окне консольного приложения.

-cfg <имя_файла>
   Задать имя файла конфигурации с параметрами командной строки (текстовый файл, каждая строка которого содержит по одному параметру). Если параметр не задан, будет выбран файл "balcon.cfg" в той же папке, что и консольное приложение.

-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, tk, 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.82
Copyright (c) 2013-2023 Ilya Morozov
Todos los derechos reservados

WWW: https://www.cross-plus-a.com/es/bconsole.htm
Correo electrónico: [email protected]

Licencia: Gratuito (Freeware)
Sistema operativo: Microsoft Windows XP/Vista/7/8/10/11
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 (Language 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.

-dp
   Muestra información del progreso en una ventana de la consola.

-cfg <file_name>
   Sets the name of the configuration file with the command line options (a text file where each line contains one option). If the option is not specified, the file "balcon.cfg" in the same folder as the utility will be used.

-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, tk, 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.

###

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: 2EC1945187EEB07AA27052DB2E60139BBEB3BF81F8BA549C4A2360363AB4338E
    ChecksumDll: 01BB04EC2D815CE30A5B4D9EDCADA479461D3DE31C78532468C398BC4C328505

4. Check that they match checksums of files included in package

Virus Scan Results

libsamplerate.dll (01bb04ec2d81) - ## / 68
balcon.1.82.nupkg (7ec104b02521) - ## / 66
balcon.exe (2ec1945187ee) - ## / 71

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 History

Version	Downloads	Last Updated	Status
Balabolka Console (balcon) 1.82	51	Thursday, December 14, 2023	Approved
Balabolka Console (balcon) 1.81	72	Sunday, August 6, 2023	Approved
Balabolka Console (balcon) 1.80	88	Sunday, May 21, 2023	Approved
Balabolka Console (balcon) 1.79	172	Sunday, March 13, 2022	Approved
Balabolka Console (balcon) 1.78	148	Wednesday, May 26, 2021	Approved
Balabolka Console (balcon) 1.77	106	Friday, May 14, 2021	Approved
Balabolka Console (balcon) 1.75	100	Thursday, April 8, 2021	Approved
Balabolka Console (balcon) 1.74	86	Saturday, March 20, 2021	Approved
Balabolka Console (balcon) 1.73	108	Sunday, March 14, 2021	Approved

2021 Ilya Morozov

Release Notes

http://www.cross-plus-a.com/balcon/changelog.txt

Dependencies

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.

Resources

Events

Courses

931

51

14 Dec 2023

Balabolka Console (balcon)

Balabolka Console (balcon) 1.82

Some Checks Have Failed or Are Not Yet Complete

Deployment Method: Individual Install, Upgrade, & Uninstall

Deployment Method:

1. Enter Your Internal Repository Url

2. Setup Your Environment

1. Ensure you are set for organizational deployment

2. Get the package into your environment

3. Copy Your Script

4. If applicable - Chocolatey configuration/installation

Ground Rules: