{"id":30876365,"url":"https://github.com/telekom/citykey-android","last_synced_at":"2025-09-08T02:09:27.121Z","repository":{"id":283452795,"uuid":"884742788","full_name":"telekom/CityKey-Android","owner":"telekom","description":"The CityKey Android App. Citykey is an urban living companion designed to enhance the experience of residents and visitors in German cities.","archived":false,"fork":false,"pushed_at":"2025-05-13T09:09:42.000Z","size":35013,"stargazers_count":2,"open_issues_count":1,"forks_count":2,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-08-28T23:09:56.795Z","etag":null,"topics":["android","android-app","citykey","deutsche-telekom","internet-of-things","iot","iot-platform","kotlin","open-source","open-source-app","smart-city","t-mobile","telekom"],"latest_commit_sha":null,"homepage":"https://citykey.app/index-en","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/telekom.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-11-07T10:03:12.000Z","updated_at":"2025-05-13T09:09:46.000Z","dependencies_parsed_at":"2025-04-28T13:36:15.705Z","dependency_job_id":"ab8d67fa-9a9e-49a2-925b-9576bdd0077d","html_url":"https://github.com/telekom/CityKey-Android","commit_stats":null,"previous_names":["telekom/citykey-android"],"tags_count":0,"template":false,"template_full_name":"telekom/reuse-template","purl":"pkg:github/telekom/CityKey-Android","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/telekom%2FCityKey-Android","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/telekom%2FCityKey-Android/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/telekom%2FCityKey-Android/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/telekom%2FCityKey-Android/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/telekom","download_url":"https://codeload.github.com/telekom/CityKey-Android/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/telekom%2FCityKey-Android/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274121957,"owners_count":25225801,"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-09-08T02:00:09.813Z","response_time":121,"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":["android","android-app","citykey","deutsche-telekom","internet-of-things","iot","iot-platform","kotlin","open-source","open-source-app","smart-city","t-mobile","telekom"],"created_at":"2025-09-08T02:09:22.332Z","updated_at":"2025-09-08T02:09:27.113Z","avatar_url":"https://github.com/telekom.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!--\nSPDX-FileCopyrightText: 2024 Deutsche Telekom AG\n\nSPDX-License-Identifier: CC0-1.0\n--\u003e\n\n![Citykey App's Overview](./images/cover.png)\n\n# Android App of Citykey \n[![Apache-2.0](https://img.shields.io/badge/license-Apache%202.0-blue)](https://opensource.org/license/apache-2-0) \n[![OpenSSF Scorecard Score](https://api.scorecard.dev/projects/github.com/telekom/CityKey-Android/badge)](https://scorecard.dev/viewer/?uri=github.com/telekom/CityKey-Android/badge) \n[![REUSE status](https://api.reuse.software/badge/github.com/telekom/CityKey-android)](https://api.reuse.software/info/github.com/telekom/CityKey-android)\n[![ktlint](https://img.shields.io/badge/ktlint%20code--style-%E2%9D%A4-FF4081)](https://pinterest.github.io/ktlint/)\n[![Continuous Integration](https://github.com/telekom/CityKey-Android/actions/workflows/continuous-integration.yml/badge.svg)](https://github.com/telekom/CityKey-Android/actions/workflows/continuous-integration.yml)\n\n## Overview\n\nCitykey is an urban living companion developed by [Deutsche Telekom AG](https://www.telekom.com/de),\ndesigned to enhance the experience of residents and visitors in German cities. The app provides easy\naccess to local services, events, and transportation information, making it a must-have tool for\nnavigating urban environments. It is the digital way to access the citizen services.\n\nPlease [visit the website](https://citykey.app) for more information!\n\n## Want to try out?\n\nCitykey app is free for downloading available on the PlayStore\n\n\u003ca href=\"https://play.google.com/store/apps/details?id=com.telekom.citykey\" style=\"display: inline-block; overflow: hidden; border-radius: 13px; width: 250px;\"\u003e\n    \u003cimg src=\"https://play.google.com/intl/en_us/badges/static/images/badges/en_badge_web_generic.png\" alt=\"Get it on Google Play\" style=\"border-radius: 13px; width: 250px;\"\u003e\n\u003c/a\u003e\n\n## Features\n\n- **Garbage collection calendar:🚛**:\n    - Distinguish between different types of garbage, such as residual waste, waste paper and\n      organic waste\n    - Always up-to-date and street-accurate\n    - The smart garbage collection calendar helps you plan weeks in advance\n- **Find events / activities:🎭**:\n  Always stay in the loop about interesting events in your city!\n    - Find festivals, events and cultural activities in your area\n    - Use built-in filters for your interests\n    - Citykey shows you an overview of upcoming events\n    - Share exciting events with your friends over Citykey\n    - Add activities and events to your calendar\n- **News:🛰**:\n    - Keep track of the latest city-related news\n    - Get daily updates about important topics, such as culture, community, citizens, nature and\n      helpful news\n- **Book appointments with offices:👨‍💼**:\n    - Book appointments with your local office and minimize waiting times when dealing with\n      authorities\n    - Ensure you have all documents required for your appointment and get the location to easily\n      find the office\n- **Digital administration with your eID:📱**:\n    - Fill out forms for various administrative purposes\n    - Citykey supports the Online ID (eID) of the ID card for identification on the Internet, so you\n      can use even more citizen services digitally and mobile-friendly. The electronic residence\n      permit is also supported\n    - Take care of common applications in no time at all, such as applying for a resident parking\n      permit or changing your residency\n- **Citizen participation:📝**:\n  Shaping the city together is now made even easier.\n    - Take part in surveys on urban development and all projects that affect you\n    - View all ongoing surveys in an overview\n- **Interesting places:🌃**:\n  New to your city? Get the best tips and first-hand information.\n    - Find out what characterizes the city and which places are worth a visit\n    - The app helps you find your way around and get familiar with the city faster\n- **Defect reporter:🤳🚧**:\n  A deep pothole in the road, a crooked guard rail or a defective street light caught your eye?\n    - Report damaged or defective infrastructure to the city\n    - Detail your request, simply by sending a photo with a location marker\n\n## Building From Source\n\nIf you want to start working on Citykey and if you haven't done already, you\nshould [familiarize yourself with Android development](https://developer.android.com/training/basics/firstapp/index.html)\nand [set up a development environment](https://developer.android.com/sdk/index.html).\n\nThe next step is to clone the source code repository.\n\n    git clone https://github.com/telekom/CityKey-Android.git\n\nThen, in the file `secrets.properties` present in the root folder, put your own Google Maps API key.\n\nUse `debug` build variant to run the application for debugging purpose.\n\nIf you don't want to use an IDE like Android Studio, you can build Citykey on the command line as\nfollows.\n\n    ./gradlew assembleRelease\n\n## Contribute\n\nCode contributions are welcome!\n\nYou should fork the repo as described\n[here](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo).\n\nSee the issues list for bug\nreports: [Citykey-Android issues](https://github.com/telekom/CityKey-Android/issues).\n\nBefore adding new features, please create an issue, or [contact\nus](https://public.telekom.de/digitalisierungsloesungen/smart-city#Kontaktaufnahme).\n\nSee the [CONTRIBUTING](CONTRIBUTING.md) file for more details.\n\n## Documentation\n\nAll the relevant documentation for this project is kept under [documentation](./documentation) directory. Here you will find:\n1. [Guide to add new Services (APIs)](https://github.com/telekom/CityKey-Android/blob/main/documentation/API_INTEGRATION.md).\n\n## Code of Conduct\n\nThis project has adopted the [Contributor Covenant](https://www.contributor-covenant.org/) in version 2.1 as our code of conduct.\nBy participating in this project, you agree to abide by its [Code of Conduct](CODE_OF_CONDUCT.md) at all times.\n\n## Licensing\nCopyright (c) 2025 Deutsche Telekom AG\n\nLicensed under the **Apache-2.0 (SPDX short identifier: Apache-2.0)** (the \"License\"); you may not use this file except in compliance with the License.\n\nYou may obtain a copy of the License by reviewing the file [LICENSE](./LICENSES/Apache-2.0.txt) in the repository.\n\nUnless required by applicable law or agreed to in writing, software distributed under the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the [LICENSE](./LICENSES/Apache-2.0.txt) for the specific language governing permissions and limitations under the License.\n\nIn accordance with Sections 4 and 6 of the License, the following exclusions apply:\n1. **Trademarks \u0026 Logos** – The names, logos, and trademarks of the Licensor are not covered by this License and may not be used without separate permission.\n2. **Design Rights** – Visual identities, UI/UX designs, and other graphical elements remain the property of their respective owners and are not licensed under the Apache License 2.0.\n3. **Non-Coded Copyrights** – Documentation, images, videos, and other non-software materials require separate authorization for use, modification, or distribution.\n\nThese elements are not considered part of the licensed Work or Derivative Works unless explicitly agreed otherwise. All elements must be altered, removed, or replaced before use or distribution. All rights to these materials are reserved, and Contributor accepts no liability for any infringing use. By using this repository, you agree to indemnify and hold harmless Contributor against any claims, costs, or damages arising from your use of the excluded elements.\n\n### Source Code\nThis project follows the [REUSE standard for software licensing](https://reuse.software). Each file contains copyright and license information, and license texts can be found in the [LICENSES](./LICENSES) folder. For more information visit https://reuse.software.\n\n### Deutsche Telekom Brand\nAlthough the code for the app is free and available under the Apache 2.0 license, Deutsche Telekom fully reserves all rights to the Telekom brand. To prevent users from getting confused about the source of a digital product or experience, there are strict restrictions on using the Telekom brand and design, even when built into code that we provide. For any customization other than explicitly for the Telekom, you must replace the Deutsche Telekom default theme.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftelekom%2Fcitykey-android","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftelekom%2Fcitykey-android","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftelekom%2Fcitykey-android/lists"}