KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #claude-code #codex #dsh #dsh-plugin #ai-agent #ai-agents #deepseek-harness #agent-skills #macos #cli

substitution-schedule-parser

★ 46 Open GitHub ↗

Java library for parsing schools' substitution schedules. Supports multiple different systems mainly used in the German-speaking countries, including Untis, svPlan, and DAVINCI

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# substitution-schedule-parser
[![Build Status](https://travis-ci.org/vertretungsplanme/substitution-schedule-parser.svg?branch=master)](https://travis-ci.org/vertretungsplanme/substitution-schedule-parser)
[![Coverage Status](https://img.shields.io/codecov/c/github/vertretungsplanme/substitution-schedule-parser.svg)](https://codecov.io/gh/vertretungsplanme/substitution-schedule-parser)
[Download](https://vertretungsplan.app/download/)
[![Javadocs](https://www.javadoc.io/badge/me.vertretungsplan/parser.svg)](https://www.javadoc.io/doc/me.vertretungsplan/parser)

Java library for parsing schools' substitution schedules. Supports multiple different systems mainly used in the German-speaking countries.

The Android and iOS App [vertretungsplan.app](https://vertretungsplan.app) is powered by this library and supports more than 500 schools. An [older version](https://github.com/johan12345/vertretungsplan) of the Android app is open source.

## Usage
The `sample` directory contains [a simple example](https://github.com/vertretungsplanme/substitution-schedule-parser/blob/master/sample/src/main/java/me/vertretungsplan/sample/Sample.java) that uses the library. The automatically generated Javadoc is available at [javadoc.io](https://www.javadoc.io/doc/me.vertretungsplan/parser).

Builds of the library are available through both the JCenter and Maven Central repositories. You can find instructions
how to use them with different build systems (such as Gradle and Maven)
[at the Bintray website](https://bintray.com/vertretungsplanme/maven/substitution-schedule-parser/_latestVersion). It is
also possible to download the library as a JAR file from that website.

When you use the library in your own project or do any modifications to it, please take note of the
[License](#license) it is distributed under. I would also appreciate it if you'd tell me what exciting projects you
are using the library in, just drop me a mail at info@vertretungsplan.app!

If you run into problems using this library, you can simply
[report an issue](https://github.com/johan12345/substitution-schedule-parser/issues/new) and I will try to help you
as soon as possible.

## Supported substitution schedule software systems
Below you find the currently supported substitution schedule softwares and the corresponding values for `SubstitutionScheduleData.setApi()`:

* Untis
  * Monitor-Vertretungsplan ([example](http://vertretung.lornsenschule.de/schueler/subst_001.htm)) `"untis-monitor"`
  * Vertretungsplan ([example](http://www.jkg-stuttgart.de/jkgdata/vertretungsplan/sa3.htm)) `"untis-subst"`
  * Info-Stundenplan ([example](http://www.akg-bensheim.de/akgweb2011/content/Vertretung/default.htm)) `"untis-info"`
    * Substitution tables: good support
    * Week timetables with substitution entries: experimental support, not recommended
  * Info-Stundenplan without header ([example](http://www.egwerther.de/vertretungsplan/w00000.htm)) `"untis-info-headless"`
* svPlan ([example](http://bls.infoboard-schleswig.de/dav/schueler1.html)) `"svplan"`
* DaVinci ([example](http://hochtaunusschule.de/Vertretungsplan/)) `"davinci"`
* ESchool ([example](http://eschool.topackt.com/?wp=d7406384445ce1fc9409bc90f95ccef5&go=vplan&content=x1)) `"eschool"`
* Indiware
  * XML export ([example](https://francisceum.de/vertretung/mo.xml)) `"indiware"`
  * XML export converted to HTML ([example](http://v-plan.gymnasium-nossen.de/v_plan_komplett/vplan_sch_html.html)) `"indiware"`
  * Stundenplan24.de format ([example](http://vertretungsplan.bebe-dresden.de/vplan/)) `"stundenplan24"`
  * Indiware Mobil ([example](https://www.cjd-droyssig.de/fileadmin/assets/droyssig/2014/Termine/VPmobilKlassen/)) `"indiware-mobile"`

Depending on the type of software, different options need to be supplied in `SubstitutionScheduleData.setData()`. Documentation about these parameters can be found on each parser's page in the [Javadoc](https://www.javadoc.io/doc/me.vertretungsplan/parser).

## License
This library is licensed under the [Mozilla Public License, Version 2.0](https://www.mozilla.org/en-US/MPL/2.0/).

I would like to strongly encourage people that create and use modified versions of this library, for example by fixing
bugs or adding support for a new substitution schedule software, to publish the changed source code no matter if the
resulting product is released in executable form or not (e.g. by only being run on a web server or your own computer),
even though this is only required by the terms of the license in the first case. Submitting Pull requests to
contribute your changes back to the original project is also welcome.

## Contributors
I would like to thank the following people for their contributions to this open source project:
- [Nico Alt](https://github.com/AltNico)
- [Tobias Knipping](https://github.com/to-kn)

## Contributing
When you clone the git repository, you should directly be able to run `./gradlew sample:run` to run the sample application. All dependencies will be downloaded automatically. You can also use IDEs such as IntelliJ IDEA that support the Gradle build system.

If you run into any problems building the project, you can email me at info@vertretungsplan.app or
[report an issue](https://github.com/johan12345/substitution-schedule-parser/issues/new).

Please note that we have a [Code of Conduct](https://github.com/johan12345/substitution-schedule-parser/blob/master/CODE_OF_CONDUCT.md)
in place that applies to all project-related communication.

substitution-schedule-parser

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README