{"id":34265305,"url":"https://github.com/derf/db-fakedisplay","last_synced_at":"2025-12-16T17:04:36.429Z","repository":{"id":38418637,"uuid":"2042716","full_name":"derf/db-fakedisplay","owner":"derf","description":"App/Infoscreen for Railway Departures in Germany","archived":false,"fork":false,"pushed_at":"2025-11-19T18:06:12.000Z","size":2822,"stargazers_count":83,"open_issues_count":19,"forks_count":8,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-11-19T20:07:18.680Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://dbf.finalrewind.org","language":"Perl","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/derf.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2011-07-13T15:56:39.000Z","updated_at":"2025-11-19T18:06:16.000Z","dependencies_parsed_at":"2024-01-05T01:26:30.315Z","dependency_job_id":"e4594237-c50b-4292-8a85-b7515fca69d3","html_url":"https://github.com/derf/db-fakedisplay","commit_stats":null,"previous_names":[],"tags_count":332,"template":false,"template_full_name":null,"purl":"pkg:github/derf/db-fakedisplay","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/derf%2Fdb-fakedisplay","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/derf%2Fdb-fakedisplay/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/derf%2Fdb-fakedisplay/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/derf%2Fdb-fakedisplay/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/derf","download_url":"https://codeload.github.com/derf/db-fakedisplay/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/derf%2Fdb-fakedisplay/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":27768437,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-12-16T02:00:10.477Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-12-16T17:04:34.141Z","updated_at":"2025-12-16T17:04:36.422Z","avatar_url":"https://github.com/derf.png","language":"Perl","funding_links":[],"categories":[],"sub_categories":[],"readme":"db-infoscreen - App/Infoscreen for Railway Departures in Germany\n---\n\n[db-infoscreen](https://finalrewind.org/projects/db-fakedisplay/) (formerly\ndb-fakedisplay) shows departures at public transit stops in most of Germany,\nSwitzerland, Austria, Luxembourg, Ireland, and parts of the USA. It can serve\nboth as infoscreen and web application for mobile usage. Depending on backend\nsupport, it can provide details on individual departures such as a map of the\nscheduled route, expected occupancy, and carriage formation.\n\nThere's a public [db-infoscreen service on\nfinalrewind.org](https://dbf.finalrewind.org/). You can also host your own\ninstance via carton/cpanminus or Docker if you like, see the Setup notes below.\n\n\nDependencies\n---\n\n * perl \u003e= 5.20\n * carton or cpanminus\n * build-essential\n * git\n\nInstallation\n---\n\nAfter installing the dependencies, clone the repository using git, e.g.\n\n```\ngit clone https://git.finalrewind.org/db-fakedisplay\n```\n\nMake sure that all files (including `.git`, which is used to determine the\nsoftware version) are readable by your www user, and follow the steps in the\nnext sections.\n\nPerl Dependencies\n---\n\ndb-infoscreen depends on a set of Perl modules which are documented in\n`cpanfile`. After installing the dependencies mentioned above, you can use\ncarton or cpanminus to install Perl dependencies locally.\n\nIn the project root directory (where `cpanfile` resides), run either\n\n```\ncarton install\n```\n\nor\n\n```\ncpanm --installdeps .\n```\n\nand set `PERL5LIB=.../local/lib/perl5` before running index.pl or wrap it\nwith `carton exec hypnotoad index.pl`.\n\nNote that you should provide imprint and privacy policy pages. Depending on\ntraffic volume, you may also want to increase the amount of worker processes\nand install a caching proxy in front of DBF.  See the Setup notes below.\n\nTo update your DBF installation, run `git pull`, ensure that all files are\nreadable by your www user, and re-run `carton install` or `cpanm --installdeps\n.`.\n\nInstallation with Docker\n---\n\nA db-infoscreen image is available on Docker Hub. You can install and run it\nas follows:\n\n```\ndocker pull derfnull/db-fakedisplay:latest\ndocker run --rm -p 8000:8092 -v \"$(pwd)/templates:/app/ext-templates:ro\" db-fakedisplay:latest\n```\n\nThis will make the web service available on port 8000.  Note that you should\nprovide imprint and privacy policy pages, see the Setup notes below.\n\nUse `docker run -e DBFAKEDISPLAY_WORKERS=4 ...` and similar to pass environment\nvariables to the db-infoscreen service.\n\nTo update your Docker installation, fetch a new image from Docker Hub and\nre-start the container.\n\nSetup\n---\n\nIn hypnotoad mode (recommended), db-infoscreen respects the following environment variables:\n\n| Variable | Default | Description |\n| :------- | :------ | :---------- |\n| DBFAKEDISPLAY\\_LISTEN | `http://*:8092` | IP and Port for web service |\n| DBFAKEDISPLAY\\_STATS | _None_ | File in which the total count of backend API requests (excluding those answered from cache) is written |\n| DBFAKEDISPLAY\\_IRIS\\_CACHE | `/tmp/dbf-iris-mian` | Directory for IRIS schedule cache |\n| DBFAKEDISPLAY\\_IRISRT\\_CACHE | `/tmp/dbf-iris-realtime` | Directory for IRIS realtime cache |\n| DBFAKEDISPLAY\\_WORKERS | 2 | Number of worker processes (i.e., maximum amount of concurrent requests) |\n\nSet these as needed, create `templates/imprint.html.ep` (imprint) and\n`templates/privacy.html.ep` (privacy policy), and configure your web server to\npass requests for db-infoscreen to the appropriate port. See the\n`examples` directory for imprint and privacy policy samples.\n\nYou can then use a service supervisor of your choice to run **hypnotoad index.pl**\n(using Mojolicious' hypnotoad server). See `examples/db-infoscreen.service`\nfor a systemd unit example.\n\nFor a quick\u0026dirty setup on low-traffic sites you can also use **morbo index.pl**\nor **perl index.pl daemon -m production**. In this case, DBFAKEDISPLAY\\_LISTEN\nand DBFAKEDISPLAY\\_WORKERS have no effect. Morbo accepts IP and port\nconfiguration using the `-l`/`--listen` switch (default: `http://*:3000`);\nDaemon mode respects the MOJO\\_LISTEN environment variable (default: `http://*:3000`).\n\nFor public-facing installations, you may want to enable caching in the reverse\nproxy serving DBF. See `examples/nginx-cache.conf` and\n`examples/nginx-site.conf` for nginx examples.\n\nAll code in this repository may be used under the terms of the BSD-2-Clause\n(db-infoscreen, see COPYING) and MIT (jquery, jqueryui, and marquee libraries;\nsee the respective files) licenses.  Attribution is appreciated.\n\nBackground Data Updates\n---\n\ndb-infoscreen can use \u003chttps://lib.finalrewind.org/dbdb/db_zugbildung_v1.json\u003e\nto show scheduled ICE/IC types (ICE 1/2/3/4/T, IC 1/2), wagon orders, and other\nattributes. It expects the file to be provided in `share/zugbildungsplan.json`.\n\nAs this information is updated regularly, the file is not shipped as part of\nthis db-infoscreen distribution. It is recommended to retrieve it a few minutes\nafter midnight via a daily cronjob. See `examples/dbf_update_zugbildungsplan`\nfor a shell script.\n\nDBF will periodically reload `share/zugbildungsplan.json`. You can use your\nservice supervisor (e.g. `systemctl reload db-infoscreen`) to force an\nimmediate reload. You may also ignore the file; it is entirely optional.\n\nSystem requirements\n---\n\nResource requirements depend on usage. For a few requests per second, about\n200MB (600k inodes) cache and one or two CPU cores should be sufficient.\ndb-infoscreen typically needs 50MB RAM per worker process, though calculating\nwith 100MB per worker is recommended to leave a safety margin.\n\nLicensing\n---\n\nThis project follows the REUSE specification. The copyright of individual files\nis documented in the file's header or in .reuse/dep5. The referenced licenses\nare stored in the LICENSES directory.\n\nThe program code of db-infoscreen is licensed under the terms of the GNU AGPL\nv3. HTML Templates and SASS/CSS layout are licensed under the terms of the\n2-Clause BSD License. This means that you are free to host your own\ndb-infoscreen instance, both for personal/internal and public use, under the\nfollowing conditions.\n\n* You are free to change HTML/SASS/CSS templates as you see fit (though you\n  must not remove the copyright headers).\n* If you make changes to the program code, that is, a file below lib/ or a\n  db-infoscreen javascript file below public/static/js/, you must make those\n  changes available to the public.\n\nThe easiest way of making changes available is by maintaining a public fork of\nthe Git repository. A tarball is also acceptable. Please change `source_url` in\n`lib/DBInfoscreen.pm` to point to your Git repository / source archive if you\nare using a version with custom changes.\n\nResources\n---\n\nMirrors of the db-infoscreen repository are available at\n\n* [Chaosdorf](https://chaosdorf.de/git/derf/db-infoscreen)\n* [git.finalrewind.org](https://git.finalrewind.org/db-fakedisplay/)\n* [GitHub](https://github.com/derf/db-fakedisplay)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fderf%2Fdb-fakedisplay","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fderf%2Fdb-fakedisplay","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fderf%2Fdb-fakedisplay/lists"}