{"id":28426623,"url":"https://github.com/keep94/birthday","last_synced_at":"2025-07-27T00:13:27.708Z","repository":{"id":50413538,"uuid":"305010349","full_name":"keep94/birthday","owner":"keep94","description":"A birthday and special day reminder system","archived":false,"fork":false,"pushed_at":"2025-04-26T15:17:11.000Z","size":170,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-06-30T04:40:51.079Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/keep94.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}},"created_at":"2020-10-18T02:53:50.000Z","updated_at":"2025-04-26T15:17:14.000Z","dependencies_parsed_at":"2024-06-21T09:56:57.899Z","dependency_job_id":"7b1f5e6b-6cde-491c-9deb-3e5108378c00","html_url":"https://github.com/keep94/birthday","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/keep94/birthday","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/keep94%2Fbirthday","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/keep94%2Fbirthday/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/keep94%2Fbirthday/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/keep94%2Fbirthday/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/keep94","download_url":"https://codeload.github.com/keep94/birthday/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/keep94%2Fbirthday/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267273902,"owners_count":24062659,"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-07-26T02:00:08.937Z","response_time":62,"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-06-05T11:10:42.510Z","updated_at":"2025-07-27T00:13:27.703Z","avatar_url":"https://github.com/keep94.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# birthday\n\nA birthday and special day reminder system.\n\nThis program is a webserver that reads names and birthdays from a text file and shows upcoming special days for those people. A special day is any of the following:\n\n- A person's birthday\n- A person turning a multiple of 1000 days old\n- A person turning a multiple of 100 weeks old\n- A person turning a multiple of 100 months old\n\n## Format of the text file\n\nThe text file is a TSV file (tab delimited file) with two fields per record:\n\n- Name\n- Date of Birth (MM/dd/yyyy format. Use MM/dd format if you don't know the year a person was born)\n\nA sample text file may look like this:\n\n```\nJohn Smith\t3/25/1967\nBill Shaw\t12/07/1973\nKatie Long\t3/21/2010\nMerna Heitcamp\t5/17\n```\n\nAlthough the records in the file can be in any order, I recommend ordering by name to make it easier to make updates to the file.\n\n## Building\n\nTo build the server, do the following:\n\n- Download golang\n- In your home directory, create a go/src/github.com/keep94 folder\n- cd to that folder.\n- Then run `git clone git@github.com:keep94/birthday.git`\n- Run `cd birthday`\n- Run `go install ./...` there\n- You will find the executable at $HOME/go/bin/remind\n\n## Running the server\n\nUse `$HOME/go/bin/remind -file path/to/tsv/file -http \":8283\"`\n\nThis tells the web server to use path/to/tsv/file for the birthdays and to\nlisten on port 8283. \n\nIf you point your browser to `http://localhost:8283`, you will see the upcoming special events. You get redirected to `http://localhost:8283/home`\n\nYou can use `$HOME/go/bin/remind -file path/to/tsv/file` and the port defaults to 8080.\n\nYou can only see the first 100 special events.\n\nThe rest of this document assumes the webserver is listening on port 8080.\n\n## Special tricks for viewing upcoming special days\n\nBy default, you see upcoming reminders for special days from today up to but not including 21 days from now. The reminders for today come first and are in italics.\n\n### Want to see if any special days happened yesterday or the day before\n\nPoint your browser to `http://localhost:8080/home?date=5/1` Where date is the month and day of the current year. If you want to go back to a prior year, you can use `http://localhost:8080/home?date=12/28/2023`\n\n### Want to see special days for one person\n\nPoint your browser to `http://localhost:8080/home?q=perez\u0026days=365` This shows only people with perez in their name and shows all special days up to but not including 365 days from now.\n\n### Want to see only birthdays and no other special days\n\nPoint your browser to `http://localhost:8080/home?p=y`\n\nThe p parameter controls what types of special days show up. Special day types are as follows:\n\n| Letter | Description |\n| ------ | ----------- |\n| y | traditional birthday |\n| d | 1000 day multiple |\n| w | 100 week multiple |\n| m | 100 month multiple |\n| h | 6 month multiple. Traditional birthdays and half birthdays |\n\nIf you wanted to see only traditional birthdays and 100 month multiples, you would use p=ym.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkeep94%2Fbirthday","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkeep94%2Fbirthday","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkeep94%2Fbirthday/lists"}