Looking for a freelancer to develop a plugin: Misspelled Word Counter

  • I need a plugin for Notepad++ that tells me:

    1. The total number of words in the document
    2. The number of unique words
    3. The total number of non-misspelled words
    4. The total number of misspelled words, both as a number and as a percentage of the total number of words in the document
    5. The number of unique misspelled words, both as a number and as a percentage of the total number of words in the document.

    For example, in this document, you can see that there are 3 misspelled words, but only 2 unique misspelled words:

    The plugin should be able to produce the following window after pressing a keyboard shortcut:

    If you can manage to show the “Unique misspelled words” information in real time, while I type, even better!!

    I’ve posted this project on Freelancer.com:

    Feel free to PM me here or via Freelancer. I look forward to finding someone to develop this! I’m a Spanish Tutor on italki and I write short stories for my students.

    To the mods: Hi! Sorry if this is the wrong place for this. I looked around but could not find the forum rules.

  • @Miguel-Lescano

    What is your definition of a misspelled word?
    What I mean is, there has to be some sort of dictionary of correct words.
    Where is this dictionary?

  • Hi, Alan. I forgot to add: I’m using the plugin “DSpellCheck”. So my definition of a misspelled word is any word that DSpellCheck considers “misspelled”. I’m actually using custom dictionaries with DSpellCheck.

  • @Miguel-Lescano

    You can actually already get the number of “words” in your document.
    Go to the View menu and choose Summary… and you’ll see something like this:


    One thing to beware of is one person’s definition of a “word” does not necessarily align with another person’s.

  • @Alan-Kilborn I’m fine with Notepad++ definition of “word”. And I know I can do these calculations manually. I just want a plugin to do it faster.

  • @Miguel-Lescano

    I’m curious, it seems you already have a plugin that does this.
    At least the screenshot implies you have such a plugin.
    What’s wrong with it?
    If it is a mock, then a pythonscript solution, which means you
    need to install PythonScript plugin, might look like this.

    from Npp import editor, notepad
    words = []
    indicator_id = 19  # used by DSpellChecker if I'm correct
    def collect_words(m):
        span = m.span()
        words.append((editor.getTextRange(*span), span))
    editor.research('\w+', collect_words)
    error_words = [word
                   for word, pos in words
                   if editor.indicatorValueAt(indicator_id, pos[0])]
    total = len(words)
    unique = len(set(words))
    misspelled = len(error_words)
    misspelled_unique = len(set(error_words))
    report = '''Total words: {0}
    Unique words: {1}
    Total non-misspelled words: {2} ({3:.1%})
    Total misspelled words: {4} ({5:.1%})
    Unique misspelled words: {6} ({7:.1%})
               total-misspelled,  # non-misspelled
               (float(total-misspelled) / total) if misspelled else 1, # non-misspelled %
               (float(misspelled) / total) if misspelled else 0,
               (float(misspelled_unique) / total) if misspelled_unique else 0)
    notepad.messageBox(report,'Misspelled Words Report')

  • @Ekopalypse

    Umm, did you just short-circuit people’s ability to make money on this?? :-)

  • @Alan-Kilborn

    ?? hää ??

  • @Ekopalypse

    Ohhhh - I see. @Miguel-Lescano, please consider donating to @donho instead.

  • @Ekopalypse Hi! Yes, it’s just a mockup made with GIMP. I like creating mockups to make my ideas clearer.

    Your script worked! Can I buy you a drink? How do I donate to @donho?

  • BTW, it seems to only take into account misspelled words that are currently on screen. It does not take into account those offscreen… Is there any way to solve this?

  • @Miguel-Lescano said in Looking for a freelancer to develop a plugin: Misspelled Word Counter:

    It does not take into account those offscreen… Is there any way to solve this?

    The spell check plugin doesn’t highlight words offscreen that are misspelled. Why would somebody need them highlighted if they can’t see them? :-)

    Your need is different, though.

    I think the code would have to forget about the plugin (except for its dictionary database) and do its own checking.

  • @Alan-Kilborn I see. Here’s how I do this calculation manually:

    1. I go to DSpellCheck > Additional actions > Copy all misspelling to clipboard. This copies all unique misspellings to the clipboard, one per line.
    2. I paste the result to a new document. I check how many lines the document has, or I just double-click on the status bar to pull up the summary and see how many words it has.
    3. I then open the Windows calculator and calculate the percentage of unique misspellings vs. total length of the text. This number is actually the most important to me: The percentage of unique misspellings.

    Maybe the script/plugin can also use the “copy all misspelling to clipboard” command, count the number of words in the clipboard and use that number to calculate the percentage of unique misspelled words vs. total number of words? This is the most important number of all. So, something like this would be enough:


    I guess I should clarify what I’m trying to achieve. I’m a Spanish tutor on italki and I write short stories for my students. I compiled my own list of the top 5,000 word forms a student needs to know in order to watch Netflix TV shows from Latin America and Spain. (How I built this list is a good story… for another day). So I want to be able to write stories that contain no more than 2.0% of unique words outside a particular level, in 5 levels:
    Top 1K word forms
    Top 2K word forms

    To check in real time if I’m using a word outside a list, I downloaded some DSpellCheck dictionaries (Hunspell) and replaced the content of the .dic file with my own word lists. I chose dictionaries with the letters A, B, C, D and E for this purpose:
    “Arabic” is the top 1K word forms in Spanish
    “Belarusian” is the top 2K
    “Catalan” is top 3K
    “Danish” is top 4K
    “English (Australia)” is top 5K

    This way I can write short stories for my students knowing that I’m focusing on common words instead of rare words. I keep the number of unique words outside each list at 2% or less, because that’s the top number of unknown words you can tolerate while reading and still be able to understand everything. (Extensive reading).

    So yeah, actually I could work with a plugin that ignores DSpellCheck, if that plugin contains the lists I’ve created.

  • @Miguel-Lescano said in Looking for a freelancer to develop a plugin: Misspelled Word Counter:

    I guess I should clarify what I’m trying to achieve.

    Now I understand why “amanecer” and “comunidad” were marked as misspelled words, when in fact those words were fine. Actually quite common words.


  • @Miguel-Lescano

    Yea, really your “spec” may be a bit too bound up in your current usage.
    If I were you, I’d forget about the DSpellCheck plugin stuff and what you’re currently doing, and just say what you want/need (you have started doing this, so, that’s good).

  • @Miguel-Lescano said in Looking for a freelancer to develop a plugin: Misspelled Word Counter:

    Ok, the goal is to keep the use of “not ordinary” words in the stories within a defined limit.

    What I do not understand is why you need 5 “TOP” word lists?
    I would assume that the TOP 1K words are also included in the TOP 5K list, right?
    I’m currently assuming that “Arabic, Belarusian”… is referring to A,B,…
    and that all are ONLY lists of Spanish words.

    Regarding a script, where I currently assume that this can be realized,
    what is the best way to realize this for you?

    Possibility 1: Call the script manually and display it as a dialog like in the mockup?
    Possibly output in the console for copy/paste operations?

    Possibility 2: “Realtime Analysis” - here a dialog would be annoying,
    unless the dialog should only be shown when the limit is reached.
    Possibly change the filetype, the first field in the status bar, with the “realtime data”?

    Since I am currently still at work (lunch break), I would give it a try in about 6 hours.

    Regarding the Donate, just click on this link.

  • @Ekopalypse Hi, thank you for your response.

    Yes, that’s the goal. To write stories with limited vocabulary. But it’s very difficult to write interesting stuff if you completely avoid words outside a particular list, so I want to keep the number of unique words outside a list under control. I’m a big fan of Stephen Krashen’s language acquisition hypothesis, and he’s also a promoter of extensive reading. Extensive reading is defined as reading at 95-98% comprehension. BTW, you can read some of my stories here: www.spanishinput.com. At first my goal was to write stories in 3 levels: 5,000 words, 10,000 words and 20,000 words, but then I realized that for most students it’s better to focus on the first 5,000 words. So now I’m aiming at 5 levels: Top 1K, top 2K, 3K, 4K and 5K.

    So… I need 5 lists because I’m going to write stories in 5 different levels. For beginners, the stories will focus on the top 1K words, then the second level will have stories using the top 2K words, and so on. You’re correct. The top 1K words are also included in the top 5K list.

    Ideally, I would have a Hunspell dictionary called “Spanish top 1000”, another one called “Spanish top 2000” and so on. However, I could not find a way to create new Hunspell dictionaries with custom names, so I installed some of the existing dictionaries and replaced their .dic files with my own word lists. Yes, it’s all Spanish. I chose one language starting with A, another one with B, and so on to make it easier for me to remember which one represents what.
    The one starting with A represents the 1000 Spanish word list.
    The one starting with B represents the 2000 Spanish word list
    and so on.

    Yes, a real time analysis tool would be amazing! I actually asked the owner of the easypronunciation.com website to create this tool for me:
    But it has a few problems, including:

    1. The CSS is messy and the highlight does not align properly with the text
    2. No way to save your work
    3. It’s slow, because the analysis runs on the server side. It does not run on your browser.

    So I’m looking for a local, offline solution. It took me a long time to figure out how to make Notepad++ highlight the words I need to be highlighted by replacing the Hunspell .dic files with my own lists.

    When you mention the filetype, are you referring to the field that says “Normal text file”? If this could be changed to display the info I need, it would be fantastic! I know people have asked for a real-time word counter to be included in Notepad++ for a long time, so I assumed it was not possible. That’s why I was asking for a script to create a dialog. But if it’s possible to do this realtime, yes, that’s even better!


  • @Miguel-Lescano

    here my first version.

    import os
    class WORD_CHECKER:
        def __init__(self):
            self.report = ('Total: {0:<5}  '
                           'Unique: {1:<5}  '
                           'Total non-misspelled: {2:<5}({3:.1%})  '
                           'Total misspelled: {4:<4}({5:.1%})  '
                           'Unique misspelled: {6:<4}({7:.1%})')
            editor.callbackSync(self.on_modified, [SCINTILLANOTIFICATION.MODIFIED])
            notepad.callback(self.on_buffer_activated, [NOTIFICATION.BUFFERACTIVATED])
            current_dict_path = os.path.join(notepad.getPluginConfigDir(), 'Hunspell')
            current_dict_file = os.path.join(current_dict_path, 'Spanish TOP972.dic')
            with open(current_dict_file, 'r') as f:
                self.current_dict = f.read().splitlines()[1:]   # skip length entry
        def check_words(self):
            words = []
            editor.research('\w+', lambda m: words.append(m.group()))
            error_words = [word for word in words if word.lower() not in self.current_dict]  # insensitive word check
            total = len(words)
            unique = len(set(words))
            misspelled = len(error_words)
            misspelled_unique = len(set(error_words))
                                                    total-misspelled,  # non-misspelled
                                                    (float(total-misspelled) / total) if misspelled else 1,  # non-misspelled %
                                                    (float(misspelled) / total) if misspelled else 0,
                                                    (float(misspelled_unique) / total) if misspelled_unique else 0))
        def on_modified(self, args):
            if ((args['modificationType'] & MODIFICATIONFLAGS.INSERTTEXT) or 
                (args['modificationType'] & MODIFICATIONFLAGS.DELETETEXT)):
        def on_buffer_activated(self, args):

    I assume your customized hunspell file is in .\plugins\Config\Hunspell and is a file
    having one word per line? If this is not the case, then please post a few lines how this file look like.
    Btw. to get a Spanish Top 1000 dict, just name it so. I named mine Spanish TOP972.dic and this resulted in


    Open question are

    1. How do you plan to switch between Top??? dictionaries. Is this something you do while editing a story?
    2. Currently, all open documents are affected. Do you want a toggle switch mechanism?

    Known issues:

    1. Currently it seems that my script calculates misspelled words differently than DSpellCheck,
      because with the example text I see 669 unique misspelled words whereas DSpellCheck reports 620.
      I’ll check this out.

    If something does not work as expected, take a look into the console (Plugins->PythonScript-Show Console)
    to see if there is an error logged. And if you have something else in mind, let me know.

  • Hello, @miguel-lescano and All,

    Did you notice that, since the version 1.4.16 of DSpellCheck, a new option to bookmark all lines, containing misspelled words, is available for further process, via Search > Bookmark ?

    • Support bookmarking lines containing misspelled words via additional actions

    Also, since the 1.14.0 version, this hidden option, below, could be of some interest to you :

    • Add hidden option Word_Minimum_Length to disable checking of words with length less or equal to its value

    For any DSpellCheck release, refer to :


    Best Regards,


  • @Ekopalypse Thanks a lot! It’s fantastic! I just had to change the name of the dictionary file inside the .py file and it worked!

    Yes, my customized dictionary files are in C:\Users\Miguel\AppData\Roaming\Notepad++\plugins\config\Hunspell

    And yes, it has one word per line, starting with the number of words. Here’s how it looks:
    Top 1000.PNG

    Your tip to just change the name of the .aff and the .dic files worked! The weird thing is, if I copy the .aff from arabic and just rename it, say, “Spanish TOP1000”, it works, but if I change the contents of the .aff file it treats all words with diacritics as misspellings. Strange. I guess I’ll just keep the content of the arabic .aff file. What’s supposed to be inside the .aff, anyway? Without an .aff file I noticed the dictionary won’t appear, and if I just type “Spanish” inside the .aff file it, again, marks all words with diacritics as misspellings.

    I don’t switch a lot between dictionaries when editing a story. I decide which level I’m going for and just go for it, unless I decide the story is too difficult to write at the level I chose and change the level. But I see I can just make 5 copies of the script and give them different names pointing to different dictionaries.

    Having all documents affected is not a problem. I’m very unlikely to be working on two stories for different levels at the same time.

    And yes, I noticed it calculates misspellings a bit different. The differences from DSpellCheck default settings are that DSpellCheck ignores:
    -Words containing numbers
    -ALL CAPS words, such as USA or V&M.
    -Words containing _

    There also seem to be some non-visible characters being counted as misspellings. The file I’m linking to here has 37 misspellings, but the script counts 38.

    Thanks a lot for your help! I’ve just donated to the link you provided. The donation buttons didn’t play nice with my Chrome cookies, so I had to open an incognito window.

Log in to reply