{"id":44515559,"url":"https://github.com/gewis/aurora-core","last_synced_at":"2026-05-24T00:02:46.240Z","repository":{"id":219000148,"uuid":"700831535","full_name":"GEWIS/aurora-core","owner":"GEWIS","description":"Aurora is a software suite to integrate and synchronize DMX lighting, narrowcasting screens and music.","archived":false,"fork":false,"pushed_at":"2026-05-12T19:34:21.000Z","size":377998,"stargazers_count":8,"open_issues_count":12,"forks_count":6,"subscribers_count":3,"default_branch":"develop","last_synced_at":"2026-05-12T20:23:52.616Z","etag":null,"topics":["audio-player","centurion","dmx","expressjs","narrowcasting","socketio-server","websocket-server"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/GEWIS.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2023-10-05T11:38:44.000Z","updated_at":"2026-02-13T14:56:35.000Z","dependencies_parsed_at":"2025-10-16T12:57:27.772Z","dependency_job_id":"3f7f7eaf-795a-45ad-9177-045b15a3e460","html_url":"https://github.com/GEWIS/aurora-core","commit_stats":null,"previous_names":["gewis/narrowcasting-core","gewis/aurora-core"],"tags_count":16,"template":false,"template_full_name":null,"purl":"pkg:github/GEWIS/aurora-core","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GEWIS%2Faurora-core","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GEWIS%2Faurora-core/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GEWIS%2Faurora-core/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GEWIS%2Faurora-core/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GEWIS","download_url":"https://codeload.github.com/GEWIS/aurora-core/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GEWIS%2Faurora-core/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33416315,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-23T22:14:44.296Z","status":"ssl_error","status_checked_at":"2026-05-23T22:14:43.778Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["audio-player","centurion","dmx","expressjs","narrowcasting","socketio-server","websocket-server"],"created_at":"2026-02-13T17:06:26.363Z","updated_at":"2026-05-24T00:02:46.228Z","avatar_url":"https://github.com/GEWIS.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Aurora Core\n\nAurora is the software suite that integrates and synchronizes DMX lighting, narrowcasting screens and currently playing music.\nThe system is designed around a publish-subscribe architecture, where executing clients connect to the core using SocketIO Websockets.\nEnd users can send commands to Aurora by using HTTP (in the backoffice).\n\nThis repository is the publisher or \"core\" of the system. All other applications connect to this central hub.\nThe other repositories can be found here:\n- [Aurora Backoffice](https://github.com/gewis/aurora-backoffice), used by humans to control the behaviour of Aurora.\n- [Aurora Narrowcasting Client](https://github.com/gewis/aurora-client), the subscriber for screens.\n- [Aurora Audio Player](https://github.com/gewis/aurora-lights-proxy), the subscriber for audio players.\n- [Aurora DMX Lights Proxy](https://github.com/gewis/aurora-audio-player), the subscriber for DMX controllers.\n- [Aurora Lights Simulator](https://github.com/GEWIS/aurora-lights-simulator), to develop lights effects without\nhaving access to physical hardware.\n- [Aurora Real Time Beat Detector](https://github.com/GEWIS/aurora-beat-detector), if you want lights effects\nto play on the beat of the music without having to set the tempo yourself (manually).\n\n## Prerequisites\n- NodeJS 22.\n\n## Development setup\n1. Copy `.env.example` to `.env` and fill in the environment variables.\n1. Run `yarn install`.\n1. Run `yarn dev`.\n1. The application is now running at http://localhost:3000. The API documentation can be found at http://localhost:3000/api-docs.\n\nTo get started more easily, you can seed the database using `yarn seed:gewis` or `yarn seed:hubble`.\nYou can then find the API keys for all the subscribers in the `api_key` SQL table.\n\nWhen running `yarn dev`, authentication is handled automatically by using mock endpoints. It is not needed to set up anything for this.\n\n### Integration with external services\nTo fully utilize all functionality of Aurora, some extra environment variables are required:\n- To use Spotify integration, create an app in the [Spotify Developer dashboard](https://developer.spotify.com/dashboard).\n- To use the narrowcasting poster screen, create a Trello board and have a [Trello API Key and Token](https://developer.atlassian.com/cloud/trello/guides/rest-api/authorization/#passing-token-and-key-in-api-requests).\n- To use the \"train departures\" poster on the narrowcasting poster screen, you need an [NS](https://ns.nl) key.\n- To use GEWIS photos on the narrowcasting poster screen, you need an internal GEWIS website token.\n- To use SudoSOS borrel posters, you need at least a [SudoSOS API key](https://github.com/GEWIS/sudosos-backend). \n\n### External services integrating with Aurora\nTo read more about how you can integrate your own services with Aurora (to fetch data or send commands),\nvisit the [README about Integrations](src/modules/auth/integration/README.md).\n\n## Deployment\nAurora can easily be deployed by using Docker Compose. Note that this only includes the core, backoffice and narrowcasting client.\nThe audio player and DMX lights proxy need to be installed manually onto their destined systems, as those applications require an audio output and connected ARTnet controller respectively.\n\n## Copyright\nCopyright © 2023-2025 Study Association GEWIS - Some rights reserved.\nYou can use our software freely within the limits of our license.\nHowever, we worked very hard on this project and invested a lot of time in it\nso we ask you to leave our copyright marks in place when modifying our software.\nOf course, you are free to add your own.\n\n## License\nAurora uses the AGPL-3.0 license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgewis%2Faurora-core","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgewis%2Faurora-core","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgewis%2Faurora-core/lists"}