Skip to content

ofdn/Kathabhidhana

 
 

Repository files navigation

Kathabhidhana consists of a few Free/Libre and Open Source Software, documentation to learn and use it, and open datasets that you can customize and shape your metadata.


Click to watch a quick video about this toolkit

Almost half of the 6909 living languages of the world are dying in a century’s time. In India alone, over 220 Indian languages out of the total of 780 languages have died only in last 50 years. With these languages, there dies a wealth of knowledge forever.

Kathabhidhana is an open toolkit to record a large number of words. It consists of a few free/libre and open source software, open datasets, methodologies and documentations. It can be used to record pronunciations of words to make a talking dictionary to record phonemes to create a text-to-speech software.

alt tag

We truly believe in openness and the FLOSS philosophy. So every single component of this toolkit is open. It also contains other dependency FLOSS tools that are built by many kind people in the open source movement.

A tool with many faces alt tag Wikipedia has a sister project called Wiktionary, a multilingual dictionary where you can not just find meaning of words from your own language but also equivalent meanings of foreign language words. Unlike many available dictionaries that help learn proununciations, Wiktionary does not have pronunciations of all words in all the languages. Kathabhidhana was originally started by Subhashish Panigrahi to add pronunciations to the Odia-language Wiktionary. It is adopted from a free software created by by Shrinivasan T. It works both on Linux and Mac. The iOS version of Kathabhidhana was created by Prateek Pattanaik. You can certainly create pronunciations and add them to Wiktionary. But you can use Kathabhidhana beyond that by making a large library of pronunciations that can be used to build any machine learning or Natural Language Processing (NLP) tool.

Currently several Odia-language words are being recorded, uploaded on Wikimedia Commons, and are being used in Odia Wiktionary. Feel free to use this toolkit with attribution, and even forkand build something on the top of it.

An Odia version of the resources and tutorial is available here. We are currently working on building more tutorials so that you can learn more about bettering your home studio setup, tips and tricks about batch renaming files, cleaning up using open source tools like Audacity, setting up files for batch upload on Wikimedia Commons, etc. So stay tuned.

What Does this toolkit contain?

  • A recording tool (download for Linux/Mac and iOS, watch a video introduction to Kathabhidhana, watch a video tutorial for the iOS version)
  • Instruction manual to set up the hardware and software
  • Dependency tools
  • Audacity for a post-recording batch clean up (Download, you can also check this tutorial in English, and Odia to clean up vocals for individual recordings)
  • Pattypan for batch uploading recorded and edited audio files on Wikimedia Commons
  • Open dataset: CSV, .ods for reference while creating meta data for your recordings
  • Odia→International Phonetic Alphabet (IPA)/Roman converter for adding phonetic signs in the metadata while uploading. Thiis converter works only the Odia alphabet. But you can fork and create one for your writing system too.

Prerequisites

Using a computer?

  • Linux or macOS
  • Linux running in a virtual machine

Using an iOS device? (check more here)

  • iOS (iPad or iPhone)
  • An app called Workflow

How to use it?

  1. Download and set up Kathabhidhana (see the next section)
  2. Set up your recording hardware (see mine in the picture above) e.g. microphone (if using an external one), computer settings like level
  3. Record using Kathabhidhana
  4. Batch processing using (tutorial coming soon, download Audacity from here)
  5. Manual clean up of each file (tutorial coming up soon)
  6. Setting up Pattypan and upload files on Commons (download from here)

Setting up Kathabhidhana

(you need to run the command in Linux or Mac, or Linux in a virtual machine if you're on Windows) Read in Odia

  1. Fill the words you want to record in a textfile named "file"
  2. run the below command

First dive into the folder, for instance it is the "Kathabhidhana" folder under "Documents for me: alt tag

Then run:

python voice-record.py

The next steps are quite self-explanatory. You need to choose "Y" for yes and "N" for no in the following options inside your terminal.

  1. To upload all the ogg files to Wikimedia Commons This will record the sounds in .ogg and .wav formats. You can then use a tool like Pattypan to batch-upload either the .WAV or the .ogg files on Wikimedia Commons.

Findings so far

time-taken- small • It takes about 20-25 mins to record 100 words; A batch processing to convert and do overall auto-cleanup using Audacity will take about 5 mins for a 100-word-batch; It takes an average of 30 secs for 1 word to manually clean up, check quality, trim extra portions and other such editing work (meaning it will take about 45 mins to clean up a batch of 100 words) using Audacity; It takes about 5-10 mins for setting up Pattypan to upload the cleaned up words on Wikimedia Commons; On an average one would spend roughly about 1.5 hrs from recording to cleaning up to uploading for a batch of 100 words

Other useful resources

  • Pronuncify by Asaf Bartov, a Kathabhidhana-like command line tool for both Linux/Mac and Windows.
  • LinguaLibre, a web and GUI-based tool developed by the Wikimedia France for a similar workflow like Kathabhidhana with more functions

Attribution

Blogs/media shoutouts

Talks/workshops

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%