Skip to content

Open-source braille translator and back-translator.

License

LGPL-2.1 and 2 other licenses found

Licenses found

LGPL-2.1
License.md
GPL-3.0
COPYING
LGPL-2.1
COPYING.LESSER
Notifications You must be signed in to change notification settings

surfer0627/liblouis

This branch is 8 commits behind liblouis/liblouis:master.

Folders and files

NameName
Last commit message
Last commit date
Jan 10, 2025
Jun 6, 2017
May 3, 2022
Dec 2, 2024
Jan 1, 2025
Dec 3, 2024
Dec 3, 2024
Aug 3, 2016
Oct 15, 2024
Nov 22, 2024
Jan 10, 2025
Jan 10, 2025
Dec 2, 2024
Dec 3, 2024
Oct 3, 2017
Mar 5, 2018
Nov 26, 2019
Dec 3, 2024
Dec 3, 2024
Aug 27, 2024
Nov 5, 2009
Jun 20, 2016
Apr 25, 2017
Aug 14, 2023
Nov 28, 2023
Nov 28, 2023
Dec 14, 2017
Jun 28, 2023
Dec 13, 2016
Aug 28, 2020
Dec 3, 2024
Apr 3, 2023
Mar 21, 2022
Jun 28, 2018
Jun 2, 2023
Oct 15, 2024
Jan 6, 2022
Jan 10, 2025
Jan 17, 2008
Feb 24, 2020

https://github.com/liblouis/liblouis/actions/workflows/main.yml/badge.svg https://github.com/liblouis/liblouis/actions/workflows/mingw.yml/badge.svg https://github.com/liblouis/liblouis/actions/workflows/emscripten.yml/badge.svg https://api.securityscorecards.dev/projects/github.com/liblouis/liblouis/badge

Introduction

Liblouis is an open-source braille translator and back-translator named in honor of Louis Braille. It features support for computer and literary braille, supports contracted and uncontracted translation for many languages and has support for hyphenation. New languages can easily be added through tables that support a rule- or dictionary based approach. Tools for testing and debugging tables are also included. Liblouis also supports math braille (Nemeth and Marburg).

Liblouis has features to support screen-reading programs. This has led to its use in two open-source screenreaders, NVDA and Orca. It is also used in some commercial assistive technology applications for example by ViewPlus.

Liblouis is based on the translation routines in the BRLTTY screenreader for Linux. It has, however, gone far beyond these routines. In Linux and Mac OSX it is a shared library, and in Windows it is a DLL.

Liblouis is free software licensed under the GNU LGPLv2.1+ (see the file COPYING.LESSER).

The command line tools, are licensed under the GNU GPLv3+ (see the file COPYING).

Documentation

For documentation, see the liblouis documentation (either as info file, html, txt or pdf) in the doc directory. For examples of translation tables, see en-us-g2.ctb, en-us-g1.ctb, chardefs.cti, and whatever other files they may include in the tables directory. This directory contains tables for many languages. The Nemeth files will only work with the sister library liblouisutdml.

Installation

After unpacking the distribution tarball from releases go to the directory it creates. You now have the choice to compile liblouis for either 16- or 32-bit unicode. By default it is compiled for the former. To get 32-bit Unicode run configure with --enable-ucs4.

After running ./configure run make and then sudo make install. As a final step you might have to run sudo ldconfig. For other ways of installation, see the file HACKING.

This will produce the liblouis library and the programs lou_allround (for testing the library), lou_checkhyphens, lou_checktable (for checking translation tables), lou_debug (for debugging translation tables), lou_translate (for extensive testing of forward and backwards translation) and lou_trace (for tracing if individual translations). For more details see the liblouis documentation.

If you wish to have man pages for the programs you might want to install help2man before running configure.

If you want to run the test suite with make check you should install libyaml as that will enable extensive tests on the tables. If you want to skip those tests you can do so by running configure --without-yaml.

Participating

You can contribute to Liblouis in several different ways:

  • If you have comments, questions, or want to use your knowledge to help others, come join the conversation on either the mailing list or on IRC. You can reach us at liblouis-liblouisxml@freelists.org or in channel #liblouis on irc:irc.libera.chat.
  • To report a problem or request a feature, please file an issue.
  • Of course, we welcome pull requests and patches.

Finally, if you want to see what we have for the future and learn more about our release cycles, all this information is detailed on the wiki

Release Notes

For notes on the newest and older releases see the file NEWS.

History

Liblouis was begun in 2002 largely as a business decision by ViewPlus. They believed that they could never have good braille except as part of an open source effort and knew that John Boyer was dying to start just such a project. So ViewPlus did start it on the agreement that they would give a small monthly stipend to John Boyer that allowed him to pay for sighted assistants. While ViewPlus has not contributed much to the coding, it certainly has contributed and continues to contribute to liblouis through that support of John Boyer.

About

Open-source braille translator and back-translator.

Resources

License

LGPL-2.1 and 2 other licenses found

Licenses found

LGPL-2.1
License.md
GPL-3.0
COPYING
LGPL-2.1
COPYING.LESSER

Security policy

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C 50.4%
  • M4 22.7%
  • C++ 18.4%
  • Makefile 5.7%
  • Python 1.3%
  • Shell 0.6%
  • Other 0.9%