{"id":26871442,"url":"https://github.com/popbones/mac.bundlr","last_synced_at":"2025-09-07T16:47:03.349Z","repository":{"id":94591918,"uuid":"34765756","full_name":"popbones/mac.bundlr","owner":"popbones","description":"Custom Mac OS X Document Bundle opener","archived":false,"fork":false,"pushed_at":"2015-04-29T02:39:14.000Z","size":15588,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-17T17:47:58.046Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Objective-C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/popbones.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}},"created_at":"2015-04-29T01:37:20.000Z","updated_at":"2015-04-30T04:35:14.000Z","dependencies_parsed_at":"2023-03-06T21:30:52.617Z","dependency_job_id":null,"html_url":"https://github.com/popbones/mac.bundlr","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/popbones/mac.bundlr","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/popbones%2Fmac.bundlr","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/popbones%2Fmac.bundlr/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/popbones%2Fmac.bundlr/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/popbones%2Fmac.bundlr/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/popbones","download_url":"https://codeload.github.com/popbones/mac.bundlr/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/popbones%2Fmac.bundlr/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274065596,"owners_count":25216443,"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-09-07T02:00:09.463Z","response_time":67,"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-03-31T07:19:33.277Z","updated_at":"2025-09-07T16:47:03.289Z","avatar_url":"https://github.com/popbones.png","language":"Objective-C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# mac.bundlr\n\n## Foreword\n\nThis was a side project I created about a year ago when I was frustrated about organizing my files. It is far from finished and not for everyone. And I doubt that I'll put more effort into it anytime soon. So proceed with caution if you are interested in it.\n\n## Description\n\nBundlr is a small utility to open general purposed document bundle structure, called *box* in general, in Mac OS X. It aims at define a simple but versitle bundle format called a \"box\" and open user specified file or folder in that box when accessed via Finder.\n\nIt is meant to be used when you have a set of files which are supposed to be kept together but when you actuall use those files you, most of the times, are only interested in certain part of those files.\n\nIt works a lot like the webarchive bundle created by Safari, which contains a bunch of files that should be kept together but it has only one *Entry Point*\n\nWith Bundler. You can organize the folder manually and add a extension to it and when you double click it in finder it will open specific file or folder in that box.\n\n## The catches\n\n- As for now, it doesn't support QuickLook preview. Technically a QuickLook plugin is provided, but since a QuickLook plugin cannot call another QuickLook plugin to generate the preview for the *Entry Point*, it is useless.\n\n- Also, Spotlight may not index the content of a box\n\n- For now, Bunldr only declare box types and open them, there is no functionality regarding creating box or converting existing folder into box. This has to be done manually (it's very easy though).\n\n## Predefined box types:\n\n- `.library`\n- `.box`\n- `.tvshowbox`\n- `.moviebox`\n- `.musicbox`\n- `.appbox`\n- `.privatebox`\n\nTechnically all those box types are all the same. The distinction is only for user to distinquish them by name, icon and sorting by type in Filder.\n\nYou can add your own types by editing the Info.plist of Bundlr.\n\n## Structure of box\n\nWhen a box is double clicked in Finder, Bundlr will start add look for the *Entry Point* of the box in follwing ways:\n\n- If there is a imediate sub folder named `Contents` in the box it would be used as box root. Otherwise, the box folder would be used as box root.\n- Look for file named `EntryPoint` under the box root. (tips: you can use a link or an alias for this file to point to what every file in your box.)\n- Look for Info.plist under the box root. If found use the value of `BundlrEntryPoint` as *Entry Point*.\n- Look for a folder named `Data` under the box root.\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpopbones%2Fmac.bundlr","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpopbones%2Fmac.bundlr","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpopbones%2Fmac.bundlr/lists"}