Code Monkey home page Code Monkey logo

davidacm / speechhistoryexplorer Goto Github PK

View Code? Open in Web Editor NEW

This project forked from jscholes/nvda-speech-history

8.0 2.0 4.0 69 KB

This is a fork of the speech history add-on for NVDA, created by Tyler Spivey and mantained by James Scholes. This add-on adds some features like shows a dialog with all history elements. Also, The keystrokes were updated because the original keys could present conflicts with other applications, since very common keys were used in the original add-on, E.G, f12.

License: GNU General Public License v2.0

Python 96.53% Smarty 1.72% CSS 1.75%

speechhistoryexplorer's Introduction

NVDA Speech History Explorer

This is a fork of the speech history add-on for NVDA, initially created by Tyler Spivey in 2012 and maintained by James Scholes. This add-on adds some features. Also, The keystrokes were updated because the original keys could present conflicts with other applications, since very common keys were used in the original add-on, E.G, f12.

features:

  • A command to copy the most recent spoken text to the clipboard.
  • Ability to review the 500 most recent items spoken by NVDA.
  • Show a dialog with the current most recent items spoken by NVDA. You can review, multi-select items and copy the current item or items selected.

Usage.

* Review the most recent items spoken by NVDA: press NVDA + shift + f11 (previous item) or NVDA + shift + f12 (next item).
* Copy the last item read by NVDA, or the current reviewed item: NVDA + control + f12.
* Show a dialog with the current most recent items spoken by NVDA: NVDA + alt + f12

Speech history elements.

In this dialog, you will be focused in the most recent items spoken by NVDA, the most recent item first. You can navigate the items by using up and down arrow keys. Each element will show just 100 characters, but you can see the entire contend by pressing tab key in a multiline text edit field. Those items won't update with new items spoken by NVDA. If you want to update the list of items, you must restart this dialog or press the "refresh history" button.

You can search in the entire elements in the search edit field. Type some letters or words and then, press enter. The list of items will be updated according to your search. To clean the search, just clean the text in the search edit field, and press enter. Also, a search will be made if you are in the search field, and the field loses the focus. E.G, by pressing tab or focus another control in some another way.

You can copy the current selected items, by using the copy button. This will copy all text shown in the field that contains all items selected. Also, you can copy all current items with "Copy all" button. This will copy just the current items shown in the list, each one will be separated by a newline. If you searched something, then this button will only copy the items found.

If you want to select more than one item, use same keys as on windows. E.G, shift + up and down arrow keys to do contiguous selection, control + the same keys to do uncontiguous selection. To close this dialog, press escape or close button.

Contributing fixing bugs and new features.

If you want to fix a bug or add new feature, You will need to fork this repository.

Forking the repository.

If this is your first contribution, you will first need to "fork" the SpeechHistoryExplorer repository on github:

  1. Fork this repo in your github account.
  2. Clone your forked repo locally: "git clone yourRepoUrl".
  3. Add this repo in your forked repo from the command line:
    "git remote add davidacm https://github.com/davidacm/SpeechHistoryExplorer.git".
  4. fetch my branches:
    "git fetch davidacm".
  5. Switch to the local SPE branch: "git checkout SPE".
  6. Set the local SPE to use the davidacm SPE as its upstream:
    "git branch -u davidacm/SPE".

Steps before coding.

You must use a separate "topic" branch for each issue or feature. All code should usually be based on the latest commit in the official SPE branch at the time you start the work. So, before begin to work, do the following:

  1. Remember the steps of "Forking the repository" section.
  2. Checkout to SPE branch: "git checkout SPE".
  3. Update the local SPE: "git pull".
  4. Create a new branch based on the updated SPE branch: "git checkout -b YourNewBranch".
  5. write your code.
  6. Add your work to be commited (clean unwanted files first): git "add ."
  7. create a commit: "git commit" and write the commit message.
  8. push your branch in your repository: "git push". if the branch doesn't exist, git will tell you how to deal with this.
  9. Request a pull request on my repository.

Note: the main branch is called SPE. That's because this is a repo, and I prefer to use the SPE branch. The master branch will be used to integrate important changes from the original forked repository.

speechhistoryexplorer's People

Contributors

jscholes avatar davidacm avatar cyrilleb79 avatar mzanm avatar ivnc avatar dalisoncpu avatar

Stargazers

 avatar Vsevolod Popov avatar Qais avatar Akash Kakkar avatar  avatar Ruslan Iskov avatar Josias Vásquez avatar Roberto Perez avatar

Watchers

James Cloos avatar  avatar

speechhistoryexplorer's Issues

With NVDA 2019.3.1, say all starts automatically when using arrows

Context

Testing add-ons on older NVDA versions.

STR

  • Install this add-on on NVDA 2019.3.1
  • In Keyboard settings, enable "Allow skim reading" option
  • Go to a webpage
  • Press Ctrl to be sure that reading is stopped
  • Press down arrow

Expected behaviour

The current line should be read and then NVDA should stop reading.

Actual behaviour

NVDA starts reading the whole page in say all mode.

Add-on version

2023.5.2

Solution

First the version where this issue does not occur anymore should be found.

Then you have 3 options:

  • Reduce the compatibility range
  • Keep code as is but document this known issue in the add-on's documentation (since it is not a big issue)
  • Find a solution that works both on older and newer versions of NVDA

If you do not want to investigate for a such little issue, the most logical thing would be to reduce the compa range. However, this add-on is very useful when performing test and making reports to copy last speech and it would be a pity to have it disabled on older versions. Hence my second proposal.

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.