{"id":22674263,"url":"https://github.com/ztstewart/subwayclock","last_synced_at":"2025-07-08T19:04:59.929Z","repository":{"id":57611154,"uuid":"200437610","full_name":"ztstewart/subwayclock","owner":"ztstewart","description":"A Raspberry PI based tool to display a NYC subway train arrival clock","archived":false,"fork":false,"pushed_at":"2019-08-07T02:23:36.000Z","size":2658,"stargazers_count":7,"open_issues_count":0,"forks_count":4,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-06-20T13:28:10.952Z","etag":null,"topics":["countdown-clock","golang","gtfs","mta","raspberry-pi","subway"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-2-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ztstewart.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}},"created_at":"2019-08-04T01:41:37.000Z","updated_at":"2022-12-23T21:47:16.000Z","dependencies_parsed_at":"2022-09-16T00:20:24.397Z","dependency_job_id":null,"html_url":"https://github.com/ztstewart/subwayclock","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ztstewart%2Fsubwayclock","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ztstewart%2Fsubwayclock/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ztstewart%2Fsubwayclock/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ztstewart%2Fsubwayclock/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ztstewart","download_url":"https://codeload.github.com/ztstewart/subwayclock/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228911986,"owners_count":17990774,"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":["countdown-clock","golang","gtfs","mta","raspberry-pi","subway"],"created_at":"2024-12-09T17:14:34.712Z","updated_at":"2024-12-09T17:14:35.361Z","avatar_url":"https://github.com/ztstewart.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Subwayclock\n\nSubwayclock is a simple program used to power a Raspberry PI-based countdown\nclock. The display is similar to the countdown clocks that can be seen on the\nNew York Subway platform.\n\n![Image of the subway clock on a Raspberry Pi Zero](image.jpg)\n\n# Requirements\n\nIn order to use this library, you'll need the following:\n\n1. An MTA API key. You can register for an account at: http://datamine.mta.info/\n2. A Raspberry PI. I have personally tested this on a Raspberry PI Zero W, but other models should work.\n3. An [Inky pHAT](https://shop.pimoroni.com/products/inky-phat) display.\n\n# Usage\n\n1. Clone this repo. `git clone git@github.com:ztstewart/subwayclock.git`.\n2. Modify `main.go` to use the correct stop ID for your home station and change the labels for your train line.\n3. Add your MTA API Key in the `client.NewNYCTA(\u0026client.Config{....})` line.\n4. Compile the tool: `go build`. You can compile for the Raspberry Pi a more powerful machine: `GOOS=linux GOARCH=arm GOARM=5 go build`\n5. (Optional) If you cross compiled (that is, compiled on another machine), copy the binary to your Raspberry Pi.\n6. Run the binary: `./subwayclock`. It will continuosly update its information every minute by default.\n\n# Running on boot\n\nFor convenience, there is a `subwayclock.service` file included in this repo. It is a [systemd](https://www.freedesktop.org/wiki/Software/systemd/) compatible service configuration file that you can use to stop and start this tool in compatible Linux distributions, such as Raspbian.\n\nThis is useful if this is the main use for your Raspberry Pi.\n\n1. Edit subwayclock.service to point to the user and the location of the `subwayclock` executable on your Raspberry Pi.\n2. Copy the file to the `/etc/systemd/system` directory: `sudo cp subwayclock.service /etc/systemd/system/subwayclock.service`\n3. Start the service: `sudo systemctl start subwayclock`. This will make it start drawing to your e-ink screen.\n4. Enable the service, which will start it on boot: `sudo systemctl enable subwayclock`.\n\nYou can disable the `subwayclock` service by running `sudo systemctl disable subwayclock`. This will prevent it from running on boot. To stop it temporarily, run `sudo systemctl stop subwayclock`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fztstewart%2Fsubwayclock","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fztstewart%2Fsubwayclock","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fztstewart%2Fsubwayclock/lists"}