{"id":15559896,"url":"https://github.com/czlee/debatekeeper","last_synced_at":"2025-07-11T10:34:34.280Z","repository":{"id":9737613,"uuid":"11698293","full_name":"czlee/debatekeeper","owner":"czlee","description":"Android app for timing debate speeches that rings bells automatically.","archived":false,"fork":false,"pushed_at":"2023-06-18T01:31:02.000Z","size":2937,"stargazers_count":21,"open_issues_count":14,"forks_count":20,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-03T22:36:35.393Z","etag":null,"topics":["android","debate","debating"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/czlee.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2013-07-27T01:47:22.000Z","updated_at":"2025-03-01T16:48:28.000Z","dependencies_parsed_at":"2024-10-28T11:26:34.226Z","dependency_job_id":"b62d2a21-1e1f-47de-8182-d4369850f6c4","html_url":"https://github.com/czlee/debatekeeper","commit_stats":null,"previous_names":[],"tags_count":31,"template":false,"template_full_name":null,"purl":"pkg:github/czlee/debatekeeper","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/czlee%2Fdebatekeeper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/czlee%2Fdebatekeeper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/czlee%2Fdebatekeeper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/czlee%2Fdebatekeeper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/czlee","download_url":"https://codeload.github.com/czlee/debatekeeper/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/czlee%2Fdebatekeeper/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264785587,"owners_count":23663804,"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","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","debate","debating"],"created_at":"2024-10-02T15:59:24.854Z","updated_at":"2025-07-11T10:34:34.241Z","avatar_url":"https://github.com/czlee.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg width=\"120\" src=\"/misc/icon/overall.svg\" /\u003e\n\nDebatekeeper \u0026mdash; a timekeeper for debate speeches\n=====================================================\n\n\u003c/div\u003e\n\nDebatekeeper is an Android app that times speeches in debates and rings bells automatically at the\ncorrect times.  It supports most parliamentary styles of debating, including British Parliamentary,\nAustralasian, Asian, Australian, American Parliamentary, certain forms of Canadian Parliamentary and\nall New Zealand styles.\n\nThe app rings a bell, vibrates and/or flashes the screen white (or any combination of the three) at\nbell times.  It also rings overtime bells, which are configurable.\n\nA small amount of documentation for this app is at https://github.com/czlee/debatekeeper/wiki/.\n\nThe app is [available on the Google Play Store](https://play.google.com/store/apps/details?id=net.czlee.debatekeeper\u0026pcampaignid=pcampaignidMKT-Other-global-all-co-prtnr-py-PartBadge-Mar2515-1).\n\n\u003cdiv align=\"center\"\u003e\n\u003ca href=\"https://play.google.com/store/apps/details?id=net.czlee.debatekeeper\u0026pcampaignid=pcampaignidMKT-Other-global-all-co-prtnr-py-PartBadge-Mar2515-1\" target=\"_blank\"\u003e\n\u003cimg alt='Get it on Google Play' height=\"96\" src='https://play.google.com/intl/en_us/badges/static/images/badges/en_badge_web_generic.png'/\u003e\u003c/a\u003e\n\u003c/div\u003e\n\nWhat is the status of this app?\n-------------------------------\nVersion 1.4 was rolled out in June 2023. This update was mostly just to comply with Android's\n[target API level\nrequirements](https://support.google.com/googleplay/android-developer/answer/11926878), so that the\napp doesn't get pulled from the Play Store. I don't intend to do any other work on Debatekeeper,\nother than maintaining the new [online formats\nrepository](https://github.com/czlee/debatekeeper-formats) (whose main purpose is to make it easier\nto accept new debate formats without having to update the app) and further target API upd\n\nI would love for someone new to pick up this project and run with it. It's licensed under the GPLv3,\nso any prospective developer would be bound by those licensing terms. You're welcome to contact me\nif you have any questions. See the [notes for prospective developers\nbelow](#notes-for-prospective-developers).\n\nLicence\n-------\nThis app (and all source code, with exceptions noted below) is licensed under the GNU General Public\nLicence version 3.  You can find a copy of this licence in the \"licence.txt\" file, or go to\nhttp://www.gnu.org/licenses/gpl-3.0.html.\n\nThe exception is the bell sounds.  I bought the single bell sound from SFXSource (which appears to\nbe now defunct), so I can't make it freely available.  If you want to contribute and need this file,\nget in touch with me.\n\nAdding debate styles\n--------------------\nNew debate styles should be submitted to the online debate formats repository at\nhttps://github.com/czlee/debatekeeper-formats. Instructions are in that repository.\n\nI've written a page on [how to write a debate format XML\nfile](https://github.com/czlee/debatekeeper/wiki/Writing-your-own-custom-debate-format-file). But\nit's probably easiest in the first instance to look in the [formats\nrepository](https://github.com/czlee/debatekeeper-formats) for the XML files there, and modify one\nof those.\n\nThis app doesn't do the public forum, Lincoln-Douglas or policy debate styles. There are other\nAndroid apps that do this. The reason this app can't currently do this is that it doesn't currently\nsupport preparation time that can be used by teams between speeches at their election. A discussion\nof this is in [issue #6](https://github.com/czlee/debatekeeper/issues/6).\n\nNotes for prospective developers\n--------------------------------\n\nI don't intend to work on this app beyond version 1.3 (October 2021), so if you're interested in\nhelping with development, I'd love for you to dive in and possibly take over the project. Contact me\nif you want to discuss anything, or feel free to just fork the repository and get going.\n\n_Note:_ The master branch has legacy support code for version 1.3 that should be removed in the next\nversion. I've done this on the [**remove-legacy**\nbranch](https://github.com/czlee/debatekeeper/tree/remove-legacy), so for any non-minor development,\nplease start from that branch (and merge it into master).\n\n### Files you need to build this project\n\nTo build this project, you'll need to:\n\n1. Check out this repository (and put it somewhere useful)\n\n2. Add the bell sounds, called `desk_bell.mp3`, `desk_bell_double.mp3` and `desk_bell_triple.mp3`,\n   all to the `app/src/main/res/raw/` directory. The app won't build without a sound file of some\n   sort there.  Any sound file will do.  I'm happy to provide the file to interested developers, on\n   the understanding that it is _not_ available under a free-distribution license (as discussed\n   above)—contact me at the details below.  Of course, future developers may also use other sounds,\n   including more freely available ones, if they can find a satisfactory one.\n\n### Sound file specifications\n\nIf you wish to use your own sound files for the `desk_bell*.mp3` files, here is some information\nabout them:\n- The sound is a desk bell (as the name suggests), also known as a counter bell or call bell.\n- The original `desk_bell.mp3` sound is about 2 seconds long, but this shouldn't in principle\n  matter; there is code that stops any existing playback if a new one needs to be started.\n- The `desk_bell_double.mp3` and `desk_bell_triple.mp3` sounds are just the `desk_bell.mp3` sound,\n  but repeated at an interval of 0.5 seconds. Any sound editing tool should be able to do this; I\n  used [Audacity](https://www.audacityteam.org/). The purpose of these files is just to make the\n  interval more predictable and to avoid abrupt audio stops for common multiple-bell cases.\n\n### Publishing to the Play Store\n\nIf you work on a significant update, I'll encourage you to list it under a separate Play Store\nlisting on your own account. To do this, you'll need to change the package name from\nnet.czlee.debatekeeper to something else. Feel free to rename/rebrand it if you like. Don't forget\nthat, under [the GPL-3.0](https://www.gnu.org/licenses/gpl-3.0.html), you're required to make your\ncode publicly available. Please credit me in your distribution (_e.g._ in the store listing).\n\nFor minor updates, I might consider pull requests and releasing it under the existing Play Store\nlisting. Just be aware that some pull requests have sat around for several years before I got a\nchance to look at them, and this is likely to be longer in the future.\n\nPlease don't hesitate to email me if you have any questions about how to proceed with this. I'm\nlikely to take forever with reviewing code, but I should be able to respond to emails about a\ndeveloper transition much more quickly.\n\nContacting the author\n---------------------\nYou can find my e-mail address by checking out this repository and looking at the commit authors, or\nalternatively message me on Facebook (czlee) or Twitter (@czczlee).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fczlee%2Fdebatekeeper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fczlee%2Fdebatekeeper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fczlee%2Fdebatekeeper/lists"}