{"id":24003520,"url":"https://github.com/codybrom/blankie","last_synced_at":"2025-04-30T20:07:50.875Z","repository":{"id":270735773,"uuid":"911298852","full_name":"codybrom/blankie","owner":"codybrom","description":"Ambient sound mixer for macOS inspired by Blanket. Now available on the Mac App Store.","archived":false,"fork":false,"pushed_at":"2025-04-30T19:48:09.000Z","size":57321,"stargazers_count":48,"open_issues_count":9,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-30T20:07:42.819Z","etag":null,"topics":["ambient-sounds","blanket","mac-app-store","macos","open-source","swift","swiftui"],"latest_commit_sha":null,"homepage":"https://blankie.rest","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/codybrom.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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},"funding":{"github":"codybrom"}},"created_at":"2025-01-02T17:33:21.000Z","updated_at":"2025-04-29T17:56:38.000Z","dependencies_parsed_at":"2025-04-19T03:47:21.521Z","dependency_job_id":null,"html_url":"https://github.com/codybrom/blankie","commit_stats":null,"previous_names":["codybrom/blankie"],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codybrom%2Fblankie","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codybrom%2Fblankie/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codybrom%2Fblankie/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codybrom%2Fblankie/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codybrom","download_url":"https://codeload.github.com/codybrom/blankie/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251774896,"owners_count":21641731,"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":["ambient-sounds","blanket","mac-app-store","macos","open-source","swift","swiftui"],"created_at":"2025-01-08T01:39:20.521Z","updated_at":"2025-04-30T20:07:50.870Z","avatar_url":"https://github.com/codybrom.png","language":"Swift","funding_links":["https://github.com/sponsors/codybrom"],"categories":[],"sub_categories":[],"readme":"\u003cimg src=\"docs/src/assets/icon.png\" alt=\"Blankie logo\" width=\"153\" height=\"128\" align=\"left\"/\u003e\n\n### Blankie\n\n\u003csmall\u003eAmbient sound mixer for macOS inspired by \u003ca href=\"https://github.com/rafaelmardojai/blanket\"\u003eBlanket\u003c/a\u003e\u003c/small\u003e\n\n[![macOS](https://img.shields.io/badge/14.6+-111111?logo=macOS\u0026logoColor=white\u0026logoSize=auto\u0026logoWidth=25)](https://www.apple.com/macos/)\n[![Swift](https://img.shields.io/badge/Swift%205-F05138?logo=Swift\u0026logoColor=white)](https://swift.org)\n[![SwiftUI](https://img.shields.io/badge/Swift%20UI-0071e3.svg?logo=swift\u0026logoColor=white)](https://developer.apple.com/xcode/swiftui/)\n[![Xcode](https://img.shields.io/badge/XCode%2016-007ACC?logo=xcode\u0026logoColor=white)](https://developer.apple.com/xcode/)\n[![GitHub](https://img.shields.io/github/license/codybrom/blankie.svg)](https://github.com/codybrom/blankie/blob/master/LICENSE)\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://apps.apple.com/us/app/blankie/id6740096581\"\u003e\n    \u003cp\u003e\u003cimg src=\"docs/src/assets/screenshot.png\" alt=\"Screenshot of Blankie\"\u003e\u003c/p\u003e\n    \u003cp\u003e\u003cimg src=\"docs/src/assets/download-on-mac-app-store.svg\" alt=\"Download on the Mac App Store\" width=\"200\"\u003e\u003c/p\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\n## Description\n\nBlankie makes it easy to mix different ambient sounds into a custom soundscape. Use it to focus and increase your productivity or help you fall asleep in a noisy environment. Blankie is a native macOS app with support for automatic light/dark modes, and your system or a custom accent color and global play/pause control from your keyboard's media keys, command center, or headphones.\n\n## Features\n\n- 14 high-quality ambient sounds:\n  - Nature sounds (rain, waves, birds, wind)\n  - Environmental sounds (train, city, coffee shop)\n  - White/pink noise\n- Individual volume controls for each sound\n- Global volume control\n- Preset system to save your favorite sound combinations\n- Native macOS integration:\n  - System media controls\n  - Automatic or customizable light/dark modes\n  - Automatic or custom accent colors\n\n## Supported Languages\n\nBlankie offers support in:\n\n- English\n- Español (Spanish)\n- Deutsch (German)\n- Français (French)\n- 中文 (Chinese, Simplified)\n\n## Contributing\n\nWe welcome contributions from the community! There are many ways to contribute to Blankie:\n\n- **Code**: Help fix bugs, add features, or improve performance\n- **Localization**: Help translate Blankie into your language\n- **Testing**: Try new features and report issues\n- **Documentation**: Improve our docs and website\n- **Ideas**: Submit feature requests and provide feedback\n\nBefore contributing, please review our [Contributing Guidelines](CONTRIBUTING.md) and [Code of Conduct](CODE_OF_CONDUCT.md).\n\n### Current Priority Areas for Contribution\n\nWe're currenly looking for help with:\n\n- [Adding custom sound support](https://github.com/codybrom/blankie/issues/1)\n- [Translating Blankie into other languages](https://github.com/codybrom/blankie/blob/main/CONTRIBUTING.md#translation-contributions)\n\n## Development Setup\n\n1. **Fork the repository and clone it to your local machine.**\n\n2. **Copy `Configuration.example.xcconfig` to `Configuration.xcconfig`.**\n    - Configuration.xcconfig is ignored by git to keep Bundle IDs and Team IDs private. Do not commit this file publicly to protect your work from impersonation, account misuse, and distribution conflicts.\n\n3. **Add your development team to `Configuration.xcconfig`.**\n\n      ```plaintext\n      DEVELOPMENT_TEAM = YOUR_TEAM_ID_HERE\n      ```\n\n    - **Apple Developer Program Members:**\n        - Retrieve your **Team ID**:\n            1. Open Xcode and go to **Xcode \u003e Preferences \u003e Accounts**.\n            2. Sign in with your Apple ID if you haven’t already.\n            3. Select your account, click **Manage Certificates** or **View Details**, and find your **Team ID** under your account name.\n        - Add your Team ID to `Configuration.xcconfig`:\n\n    - **If You Are Not a Member of the Apple Developer Program:**\n        - You can still test the app on your devices for free by creating an Xcode **Personal Team**. Follow these steps:\n            1. Open Xcode and go to **Xcode \u003e Preferences \u003e Accounts**.\n            2. Click the \"+\" button to add your Apple ID (if not already added).\n            3. After signing in, Xcode will automatically create a **Personal Team** associated with your Apple ID.\n            4. Go to **Xcode \u003e Preferences \u003e Accounts**, select your account, and click **View Details**. The Team ID for your Personal Team will be listed.\n        - Use the Team ID from your Personal Team in `Configuration.xcconfig`:\n\n4. **Set the Bundle Identifier:**\n\n      ```plaintext\n      PRODUCT_BUNDLE_IDENTIFIER = com.yournamehere.blankie\n      ```\n\n    - In `Configuration.xcconfig`, set `PRODUCT_BUNDLE_IDENTIFIER` to a unique identifier. You can use any reverse domain name format for the bundle identifier, but it must be unique. You **cannot** use the same bundle identifier as the main Blankie app.\n\n5. **Open `Blankie.xcodeproj` in Xcode**\n\n6. **Build and run the project!**\n\n## Documentation\n\nAdditional information about Blankie, including an FAQ and more credits, are available on the [Blankie website](https://blankie.rest). The website is created using Astro and hosted on GitHub Pages. The source code is available in the `docs` directory.\n\nInformation about the Blankie website's source code can be found in its [README](docs/README.md) file.\n\n## Credits\n\n### Special Thanks\n\nAn incredibly special thanks to [Rafael Mardojai CM](https://github.com/rafaelmardojai) and all the contributors to the [Blanket](https://github.com/rafaelmardojai/blanket) project which inspired me to build this app when I couldn't find a free, simple and open-source Mac app like it.\n\n### Sounds\n\nThe sounds in Blankie are used under various open licenses. Full attribution information about sounds and licensing is available on the Blankie website at [blankie.rest/credits](https://blankie.rest/credits) or on the About screen of the app.\n\n### App Logo / Icon\n\nThe Blankie logo and app icon were created by [Cody Bromley](https://github.com/codybrom) and are licensed under a \u003ca href=\"https://creativecommons.org/licenses/by/4.0/?ref=chooser-v1\" target=\"_blank\" rel=\"license noopener noreferrer\"\u003eCreative Commons Attribution 4.0 International license \u003cimg style=\"height:22px!important;margin-left:3px;vertical-align:text-bottom;\" src=\"https://mirrors.creativecommons.org/presskit/icons/cc.svg?ref=chooser-v1\" alt=\"\"\u003e\u003cimg style=\"height:22px!important;margin-left:3px;vertical-align:text-bottom;\" src=\"https://mirrors.creativecommons.org/presskit/icons/by.svg?ref=chooser-v1\" alt=\"\"\u003e\u003c/a\u003e\n\nYou may share, copy, and adapt the Blankie logo/icon, but you must give appropriate credit, link to the license, and indicate if changes were made.\n\nPress and media may use the Blankie app icon and logo without modification to reference the Blankie app, provided proper attribution is given.\n\n### Sound Icons\n\nBlankie uses [SF Symbols](https://developer.apple.com/sf-symbols/) for sound icons. SF Symbols are provided by Apple as a system resource, with usage governed by the [Xcode and Apple SDKs Agreement](https://www.apple.com/legal/sla/docs/xcode.pdf). They are not stored in this repository and are not covered by Blankie's license.\n\n## License \u0026 Copyright\n\n© 2025 Cody Bromley and contributors. All rights reserved.\n\nThe Blankie name and trademark rights are reserved. The Blankie logo and app icon are licensed under a [Creative Commons Attribution 4.0 International License](https://creativecommons.org/licenses/by/4.0/).\n\nThe Blankie source code and website code are copyright Cody Bromley and licensed under the MIT License. Please read Blankie's [LICENSE](LICENSE) for full details. Contributions to Blankie are welcome and will be released under the same license.\n\nDifferent components of Blankie (such as sounds, icons, or others) may be covered by different licenses. Full attribution information about sounds and licensing for included items is available on the Blankie website at [blankie.rest/credits](https://blankie.rest/credits) and on the About screen of the app.\n\n## Support \u0026 Community\n\n- 🐛 Find a bug? [Open an issue](https://github.com/codybrom/blankie/issues/new?assignees=\u0026labels=bug\u0026projects=\u0026template=bug_report.md\u0026title=BUG%3A+)\n- 💡 Have an idea? [Submit a feature request](https://github.com/codybrom/blankie/issues/new?assignees=\u0026labels=enhancement\u0026projects=\u0026template=feature_request.md\u0026title=IDEA%3A+)\n- 💬 Join the discussion in our [GitHub Discussions](https://github.com/codybrom/blankie/discussions)\n\n---\n\n\u003e Blankie is an independent macOS application inspired by Blanket. Blankie was built without re-using any code from the Blanket project, though it does use some of the same openly licensed sound files. Blankie is not affiliated with or endorsed by the Blanket team or any of its contributors.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodybrom%2Fblankie","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodybrom%2Fblankie","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodybrom%2Fblankie/lists"}