Git Product home page Git Product logo

unmute's Introduction

NVDA Unmute

This add-on checks the status of the Windows audio system when NVDA starts. And, if it turns out that the sound is muted - the add-on forcibly turns it on. At the same time, the volume level is checked separately for the NVDA process. The add-on also checks the status of the speech synthesizer. If there are problems with its initialization, attempts are made to start the synthesizer, which is specified in the NVDA settings. There is an additional opportunity to check on which audio device the NVDA sound is output. And, if this device differs from the default device, the output automatically switches to the audio device installed in the system as the main one.

Note: If the add-on startup sound always plays even if the NVDA volume is online. That is, the add-on switches the output to the main audio device each time you start NVDA. This occurs when the audio output device is in the NVDA settings is differ from the default output device or "Microsoft Sound Mapper". This can be easily solved in one of the following ways:

  1. After restarting NVDA, just save the current configuration using NVDA+Ctrl+C. The default audio device will be saved in the NVDA settings and switching will not occur each time when NVDA starts.
  2. If you don't want to change the NVDA configuration - just disable the function of switching audio devices in the Unmute settings panel.

Add-on settings dialog

The following options are available in the add-on settings dialog:

  1. The first slider in the add-on settings dialog allows you to specify the volume level of Windows, which will be set when you start NVDA if the sound was previously muted or was too low.

  2. The minimum Windows volume level at which the volume up procedure will be applied. This slider allows you to adjust the sensitivity level of the add-on. If the volume level drops to less than the value specified here, the volume will be increased the next time you start NVDA. Otherwise, if the volume level remains higher than the value specified here, then when you restart NVDA, its level will not change. And, of course, if the sound was previously turned off, when restarts add-on will turn it on anyway.

  3. The following check box allows to enable re-initialization of the voice synthesizer driver. This procedure will only start if it is detected at NVDA startup that the voice synthesizer driver has not been initialized.

  4. In this field you can specify the number of attempts to re-initialize the voice synthesizer driver. Attempts are performed cyclically with an interval of 1 second. A value of 0 means that attempts will be performed indefinitely until the procedure is successfully completed.

  5. The "Switch to the default output audio device" option allows to check at startup the audio device on which NVDA sound is output. And, if this device differs from the default device, the output automatically switches to the audio device installed in the system as the main one.

  6. The next checkbox turns on or off playing the startup sound when the operation is successful.

Change log

Version 1.5

  • added "Switch to the default output audio device" feature.

Version 1.4

  • added a method to increase the startup volume separately for the NVDA process;
  • changed the sound notification of a successful operation (thanks to Manolo);
  • all manual volume control functions have been transferred to the NVDA Volume Adjustment add-on.

Version 1.3

  • added the ability to control the volume of the main audio device and separately for each running program;
  • updated translation into Vietnamese (thanks to Dang Manh Cuong);
  • added Turkish translation (thanks to Cagri Dogan);
  • Italian translation added (thanks to Christianlm);
  • added simplified Chinese translation (thanks to Cary Rowen);
  • Polish translation added (thanks to Stefan Banita);
  • updated Ukrainian translation;
  • updated ReadMe.

Version 1.2

  • switched to using the Core Audio Windows API instead of Windows Sound Manager;
  • added startup sound playback when audio is successfully turned on by add-on.

Version 1.1

  • added add-on settings dialog;
  • updated Ukrainian translation.

Version 1.0.1

  • Performs repeated attempts to enabling the synth driver in case of its failed initialization;
  • Vietnamese translation added by Dang Manh Cuong;
  • Ukrainian translation added.

Version 1.0. Features of implementation

The add-on uses a third-party module Windows Sound Manager.

Altering NVDA Unmute

You may clone this repo to make alteration to NVDA Unmute.

Third Party dependencies

These can be installed with pip:

  • markdown
  • scons
  • python-gettext

To package the add-on for distribution:

  1. Open a command line, change to the root of this repo
  2. Run the scons command. The created add-on, if there were no errors, is placed in the current directory.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.