Skip to main content

A simple, effective sentence mining tool.

Project description

Simple Sentence Mining

Simple Sentence Mining (ssmtool) is a program for sentence mining, in which sentences with target vocabulary words are collected and added into a spaced repetition system (SRS) for language learning.

This program monitors your clipboard at all times and when a change is detected, the contents gets copied onto the "Sentence" field. From there, you can double click any word, and the program will send a query to Wiktionary, and display the result on the "Definition" field, while simultaneously filling in the "word" field for you. You may also double click from words in the "Definition" field to get definition, because Wiktionary sometimes simply lists the base forms of inflected words.

Demo

Prerequisites

Name Note
Anki with AnkiConnect Needed for exporting notes

Installation

Linux

Install with pip: pip install ssmtool

Packages on Gentoo GURU and Arch Linux AUR will be soon available.

Windows, macOS

Standalone version available in the Releases tab.

Alternatively, you can also install with pip: pip install ssmtool

(Instructions on setting up PIP on Windows)

(Instructions on setting up PIP on macOS)

Important: On macOS it is important to have Anki open on the foreground, otherwise the API will respond very slowly, causing lags in the application.

How to use

First, you need to configure it by pressing the "Configure.." button at the bottom. You only need to do it once.

With Click-Copy-Sentence

  1. Open any website
  2. Click on a word
  3. Check if the definition makes sense, if not, double-click on one of the words in the Sentence field.
  4. Click on the "Add note" button.

General use

  1. Copy any text to clipboard
  2. Click on a word in the Sentence field
  3. Check if the definition makes sense. You can also look up any word in the Definition field.
  4. Click on the "Add note" button.

Recommended tools

Disclaimer: Except for the companion web extension, these projects are not affiliated with the author of ssmtool

Service/Application Plugin Note
Netflix Subadub (Firefox, Chrome) Chrome extension to make subtitles selectable (also copy-able)
Youtube youtube-dl Download videos from youtube (videos can be played locally with subtitles, which are then copy-able with mpv).
mpv mpvacious Automatically copies subtitles to clipboard (which will show up on this tool)
Anki AwesomeTTS Automatically generates TTS for cards generated from this tool. You can configure it to produce TTS on demand for the note type used by ssmtool, complementing your flashcards.
Browser Click Copy Sentence (Firefox, Chrome version coming soon.) Companion browser extension for ssmtool. Enables single-click note creation.

Future plans

This program is still at an early stage. More features will be added soon.

Current plans include:

  • Undo
  • Usage statistics
  • Other dictionaries
  • Auto-selecting the most difficult words

Credits

All the definitions provided by the program come from the English Wiktionary, without which this program would never have been created.

App icon is made from icons by Freepik available on Flaticon.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ssmtool-0.1.13.tar.gz (52.0 kB view hashes)

Uploaded Source

Built Distribution

ssmtool-0.1.13-py3-none-any.whl (50.7 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page