Joytan

Joytan ジョイ単

<img src="./logo/joytan.png" align="right" width="90" height="90" title="logo">

Website: https://kokimame.github.io/joytan/

<p align="center"> <a href="./docs/images/app_pros.png"> <img src="./docs/images/app_pros.png" alt="Fig: Pros of Joytan" width="450" height="170"> </a> </p>

Joytan is a free, small cross-platform desktop app that facilitates the process of making audio/textbooks. With Joytan, you can create your own audio/textbooks based on what you really want to learn by yourself, such as a Memrise course and Anki cards.

Key features include:

• MP3 audiobooks with your best-loved songs and sound effects
• Lifelike speech using Amazon Polly (24 languages in 52 voices)
• 100+ voices from Text-to-Speech alternatives (by AwesomeTTS)
• High-quality HTML/PDF textbooks (and quiz)
• Saving data as CSV files, ready to export to Anki
• Google Image downloader for tons of visual aids
• Automatic lookup to various online dictionaries
• Memrise downloader
• Self-made editable pattern of audiobooks
• Original design for textbooks with basic HTML
• Data format editable on Google Sheets
• Language translation powered by Google Translation
• Simple and tiny GUI, just 3 main dialogs!

What You See

<!-- Screenshots of dialogs --> <figure> <a href="./docs/images/main_full.png"> <img src="./docs/images/main_full.png" alt="Screenshots of Input window" width="150" height="180"> </a> </figure> <figure> <a href="./docs/images/audio_full.png"> <img src="./docs/images/audio_full.png" alt="Screenshots of Textbook setting window" width="150" height="180"> </a> </figure> <figure> <a href="./docs/images/text_full.png"> <img src="./docs/images/text_full.png" alt="Screenshots of Audiobook setting window" width="150" height="180"> </a> </figure>

What You Get

We are distributing some of sample creations on YouTube. Take a look!

Audiobook Sample:

<a href="https://www.youtube.com/watch?v=tSzgD99iBE4"> <img src="https://img.youtube.com/vi/tSzgD99iBE4/0.jpg" width="260" height=180" /> </a> <a href="https://www.youtube.com/watch?v=0KR9DKZeTqk"> <img src="https://img.youtube.com/vi/0KR9DKZeTqk/0.jpg" width="260" height=180" /> </a>

See Textbook Sample (compressed)

See Matching Quiz Sample

NOTE: Videos were created from two resources. One is audiobooks which were created with Joytan, the other is image clips which were created separately from the app. Video-making feature is not included in the current version of Joytan.

Known bugs

• There are some encodings (e.g. "windows-1252") of CSV files which the app cannot load and result in a crash.
• The ffmpeg embeded in the app may not be compatible on some machines, thus the audiobook-making feature is not available.

Download & Installation

Joytan works on Windows, Mac, and Linux.

Please download & install Joytan from our website or releases.

Quick Start

Tutorials are available on our website.

• Set up Amazon Polly
• How to Organize for your book
• How to Make Audiobooks
• How to Make Textbooks

Development

Joytan requires:

• Python 3.5+
• PyQt that supports Qt 5.9+
• ffmpeg (Pydub's dependency, it may work with 'libav' but not tested)
• lame (AwesomeTTS's dependecy)

and a number of Python packages, which you can install via pip:

pip3 install -r requirements.txt

To use the development version:

git clone https://github.com/kokimame/joytan.git
cd joytan
./devscript/build_ui.sh

If you get any errors, you will not be able to proceed, so please return to the top and check the requirements again.

Now you are ready to run Joytan by:

./runapp

TODO

• Memrise Course Downloader
• More dictionary interfaces (from Weblio to Urban Dictionary)
• Chunking large audiobook in the process for memory efficiency
• Voice Recording
• Cell View (without rendering EntryList to speed up loading)
• Title/Ending editor for audiobook
• UNDO
• Drag & drop on Panel to download online images
• Search entries
• Multilingual Support
• More test

Contribution

• Report a bug: See issues
• Feature/Content request and feedback on Twitter, YouTube are appreciated.

Disclaimer

Copyright © 2017-Present Kohki Mametani (kohkimametani@gmail.com).

Joytan is lincensed under the GNU General Public License version 3.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.