LibreLingo

a community-owned language-learning platform

» Try LibreLingo now! «

💬 Chat • 👩‍💻 Contribute! • 💵 Sponsor • ☎️ Schedule a call about Librelingo

About LibreLingo

LibreLingo's mission is to create a modern language-learning platform that is owned by the community of its users. All software is licensed under AGPLv3, which guarantees the freedom to run, study, share, and modify the software. Course authors are encouraged to release their courses with free licenses.

If you want to know why I built LibreLingo, I recommend reading my article. If you agree with LibreLingo's mission, consider helping to build and maintain it, and please consider making a monetary contribution.

Table of Contents

About LibreLingo
Platform
- Web app
- librelingo-tools
Milestones
Attributions
Articles
Become a contributor

Platform

Web app
The LibreLingo web app is a lightweight, interactive web app for learning foreign languages using LibreLingo courses. Features: 🎯 practice using interactive exercises 🗓️ spaced repetition 💾 save and monitor progress 🔁 synchronise progress across multiple devices 📱 works on various devices such as phones, tablets and desktop computers Screenshots

Web app

The LibreLingo web app is a lightweight, interactive web app for learning foreign languages using LibreLingo courses.

Features:

🎯 practice using interactive exercises
🗓️ spaced repetition
💾 save and monitor progress
🔁 synchronise progress across multiple devices
📱 works on various devices such as phones, tablets and desktop computers

Screenshots

librelingo-tools
librelingo-tools is a Python 🐍 package that contains modules that help working with LibreLingo courses. Setup librelingo-tools can be installed using pip: pip install librelingo-tools Exporting courses to JSON librelingo-tools has a command line program that can export YAML-based LibreLingo courses into the JSON format used by the web app. `Usage: cli.py [OPTIONS] INPUT_PATH OUTPUT_PATH Convert a YAML course into a JSON course. Options: --dry-run / --no-dry-run --help Show this message and exit.` Loading courses in a Python program You can use librelingo-tools to load YAML-based LibreLingo courses in your Python program. from librelingo_yaml_loader import yaml_loader course = yaml_loader.load_course("./path/to/my/course") `load_course` returns a Course() object

librelingo-tools

librelingo-tools is a Python 🐍 package that contains modules that help working with LibreLingo courses.

Setup

librelingo-tools can be installed using pip:

pip install librelingo-tools

Exporting courses to JSON

librelingo-tools has a command line program that can export YAML-based LibreLingo courses into the JSON format used by the web app.

Usage: cli.py [OPTIONS] INPUT_PATH OUTPUT_PATH

  Convert a YAML course into a JSON course.

Options:
  --dry-run / --no-dry-run
  --help                    Show this message and exit.

Loading courses in a Python program

You can use librelingo-tools to load YAML-based LibreLingo courses in your Python program.

from librelingo_yaml_loader import yaml_loader

course = yaml_loader.load_course("./path/to/my/course")

load_course returns a Course() object

Milestones

Current focus
Make it possible to contribute to courses through GitHub

🏁 Demo course content in Spanish for English speakers
🏁 Some basic building blocks of course content implemented
🏁 Developers can use course editor
🏁 Basic theme/branding
🏁 Course progress can be properly synchronised across devices
🏁 Course editor can be accessed by all course contributors
🏁 At least the basics of the Spanish course are ready
🏁 Most of the course building blocks are implemented
🏁 All of the basic building blocks of courses are implemented
🏁 Spaced repetition implemented

Become a contributor

🌍 UI translation

🔗 POEditor translation project!

📖 Course content

Getting started

👩🏾‍💻 Development

You can help LibreLingo by testing it and submitting feature requests or bug reports: https://github.com/kantord/LibreLingo/issues/new. If you want to get in touch, you can use my contact details on my GitHub profile.

Confused? Have a question?

There is a Matrix/FreeNode IRC channel #LibreLingo, instructions for joining:

Matrix: #LibreLingo on matrix.org
IRC: connect to irc.freenode.net with your favourite client and join #LibreLingo

Articles

Why I built LibreLingo

License

LibreLingo is licensed under the AGPL-3.0 License. Course content and other creative content might be licensed under other licenses, such as CC.

This image shows a summary of the licensing of our dependencies:

Attributions

Mascot

Mascot images are released under Creative Commons Attribution-ShareAlike 4.0 International License.

The mascot is designed by @almostdesigner.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

_{Daniel Kantor} 💻	_{Klemen Skerbiš} 🤔	_{Mirek Mazel} 🤔	_{Chris Babcock} 🤔	_{Liaizon Wakest} 🤔	_{Trolli Schmittlauch} 🤔	_{Jérôme Deuchnord} 🤔
_{Felix Ableitner} 🐛	_{Navan Chauhan} 🚇 💻 🎨 📖	_{Roshan Jossy} 🤔 💻 📖	_ledgelight 🤔	_{Francis Tyers} 🤔 📖	_titanix 🤔	_{Michael Moroni} 🌍
_pssandhu 🎨	_{Stefan Lobbenmeier} 🐛	_kylepollina 💻	_slesingerm 🤔 🐛 👀	_iasonasma 💻 ⚠️	_{Caroline Delesalle} 🎨	_borbota 🐛
_decentral1se 📖 🤔	_{James Adams} 🐛	_{Arnold Schrijver} 🤔	_{Dale Visser} 🐛	_{oscarfrancois} 📖	_dhelmr 💻	_Matt 👀 🐛 🚧 💻 📖
_{Jean-André Santoni} 🤔 📖 🎨	_{Lucas Campos Teixeira e Nascimento} 📖 🤔	_{Pooja Desur} 📖	_{Wesley Mutwiri} 💻	_{Simon B.} 🤔	_{Karthik Shetty} 🚧	_{Joshua Ide} 💻
_{Jobe Dylbas} 💻	_{Dávid Kristián Luterančík} 🤔 💻	_{Sai Sandeep Mutyala} 💻	_{Artur Bauer} 💻	_Etza 💻	_{Kyle Mumma} 💻 🤔	_zinovik 💻
_{Himank Pathak} 💻 🐛	_x4th 💻	_{Christian Dimas} 💻	_{Marco Ciampa} 🐛	_{Joshua \| DC7IA} 🐛	_Reyzadren 🤔	_Andreas 📖
_{Marco H} 🖋	_{Dan OReilly} 🤔	_{Douglas Ferlini} 💻	_{Michael Nock} 💻 🤔	_davidak 🤔	_adnan360 🖋	_Lamdarer 📖