{"id":16294123,"url":"https://github.com/fnesveda/namedays","last_synced_at":"2025-04-09T11:15:54.306Z","repository":{"id":87224710,"uuid":"205006470","full_name":"fnesveda/Namedays","owner":"fnesveda","description":"A Mac app which displays Czech namedays in the menubar","archived":false,"fork":false,"pushed_at":"2019-09-02T10:57:34.000Z","size":848,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-15T05:16:15.609Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://www.nesveda.com/projects/Namedays/","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fnesveda.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}},"created_at":"2019-08-28T19:20:32.000Z","updated_at":"2023-02-20T18:11:13.000Z","dependencies_parsed_at":"2023-03-02T06:30:38.842Z","dependency_job_id":null,"html_url":"https://github.com/fnesveda/Namedays","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fnesveda%2FNamedays","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fnesveda%2FNamedays/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fnesveda%2FNamedays/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fnesveda%2FNamedays/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fnesveda","download_url":"https://codeload.github.com/fnesveda/Namedays/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248027414,"owners_count":21035594,"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":[],"created_at":"2024-10-10T20:14:15.864Z","updated_at":"2025-04-09T11:15:54.270Z","avatar_url":"https://github.com/fnesveda.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\u003cimg src=\"docs/images/logo.png\" alt=\"Logo of the project\"\u003e\u003c/p\u003e\n\u003ch1 align=\"center\"\u003eNamedays\u003c/h1\u003e\n\u003cbr\u003e\n\u003cp align=\"center\"\u003eA Mac app which displays Czech namedays in the menubar.\u003c/p\u003e\n\u003cbr\u003e\n\u003cp align=\"center\"\u003e\u003cimg src=\"docs/images/screenshots/main.png\" alt=\"A screenshot of the application\"\u003e\u003c/p\u003e\n\nAbout\n-----\n*Namedays* is a small utility which shows the current and future Czech namedays in the menubar of your Mac.\n\nThis is a small summer project which I did to get some practice with developing Mac apps. There are a few similar projects available, but they are either abandoned or paid, so I wanted to make a free, simple, open source alternative to replace them.\n\nInstallation\n------------\n*Namedays* supports macOS 10.11 El Capitan and higher.\n\nTo install, download the [latest DMG release](https://www.github.com/fnesveda/Namedays/releases/latest), open it and drag *Namedays.app* to your *Applications* folder.\n\nUsage\n-----\nThe app simply shows the nameday for the current date in the menubar of your Mac.\nWhen you click on the menubar item, a menu opens showing namedays for several days in the future.\n\nIn the app's preferences, accessible from the menu, you can customize the number of future namedays displayed in the menu or control the login item of the app.\n\nDeveloping\n----------\nThe app is a standard Xcode \u0026 Swift project without any external dependencies. You can just download or clone the repository and open *src/Namedays.xcodeproj* to start making changes. \n\nThe whole project is written in Swift 4.2, without using any Objective-C bridging headers.\n\n\n### Quirks and perks\n\nDue to the way the app manages its login item (through [Launch Services](https://developer.apple.com/documentation/coreservices/launch_services)), App Sandbox can't be enabled. This means the app can't be released on the Mac App Store, at least for now.\n\n*LoginItemManager.swift* contains an implementation of a login item manager for the app.\nThere is a bunch of login item managers available already, I implemented it in a way that you can bind the property *isEnabled* of the manager to a checkbox in Interface Builder through the included value transformer *LoginItemCheckboxTransformer*. \nUnfortunately, Apple deprecated the APIs to access the login item list starting from Sierra, without offering any real alternative.\nI hope these will keep working for at least a few more years, but eventually this will need to be rewritten to utilize the Service Management Framework, which will have the side effect of not showing the login item in System Preferences.\n\nLinks\n-----\n- [Project homepage](https://www.nesveda.com/projects/Namedays/)\n- [Project repository](https://www.github.com/fnesveda/Namedays/)\n\nLicensing\n---------\nThe code in this project is licensed under the MIT license.\nEverybody is welcome to use, change and modify the project as they see fit.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffnesveda%2Fnamedays","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffnesveda%2Fnamedays","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffnesveda%2Fnamedays/lists"}