{"id":20909854,"url":"https://github.com/un1xg0d/curator","last_synced_at":"2026-04-20T20:03:02.230Z","repository":{"id":106020843,"uuid":"431094800","full_name":"Un1xG0d/Curator","owner":"Un1xG0d","description":"Interactively view your NFTs with augmented reality.","archived":false,"fork":false,"pushed_at":"2022-03-10T11:20:38.000Z","size":76426,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-19T15:19:44.119Z","etag":null,"topics":["arkit","augmented-reality","nft","opensea-api","usdz","waxio"],"latest_commit_sha":null,"homepage":"https://nftcurator.herokuapp.com","language":"PHP","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/Un1xG0d.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-11-23T12:38:23.000Z","updated_at":"2023-09-20T00:12:04.000Z","dependencies_parsed_at":null,"dependency_job_id":"9558921a-de4d-4d9c-a713-e9f5f8914d4c","html_url":"https://github.com/Un1xG0d/Curator","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/Un1xG0d%2FCurator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Un1xG0d%2FCurator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Un1xG0d%2FCurator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Un1xG0d%2FCurator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Un1xG0d","download_url":"https://codeload.github.com/Un1xG0d/Curator/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243301122,"owners_count":20269286,"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":["arkit","augmented-reality","nft","opensea-api","usdz","waxio"],"created_at":"2024-11-18T14:13:03.403Z","updated_at":"2025-12-24T20:47:16.725Z","avatar_url":"https://github.com/Un1xG0d.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Curator\nUse augmented reality to transform your room into a museum for interactively viewing your NFT collection. Curator generates custom ARKit experiences from your personal NFTs.\n\n## Video demo\n[Watch on YouTube](https://youtu.be/Vkl_d8XTU5U)\n\n## Usage\n1. View your token on the OpenSea website/app.\n2. Copy the entire URL to your clipboard.\n3. Paste it into the specified textfield on Curator’s homepage.\n4. Tap the 3D model you want to customize.\n5. Aim your iPhone at a flat surface (like a table or the floor) and let the camera stabilize.\n\n## Technical details\nCurator is a [Dockerized](https://docs.docker.com/) web application that can load an [NFT](https://en.wikipedia.org/wiki/Non-fungible_token) onto a collection of 3D models.\n\n[Blender](https://www.blender.org/) is used to pre-build the 3D models and texture them with a placeholder NFT image. All image textures must be stored in the `/var/www/html/models/\u003cmodel_name\u003e/` directory while building \u0026 exporting the model. Any mesh intended to hold the user’s NFT image should be textured with a placeholder image named `nft.png` in that same directory.  The model is exported to an [FBX](https://www.autodesk.com/developer-network/platform-technologies/fbx-sdk-2020-0) file with the filename `\u003cmodel_name\u003e.fbx`. Once the export is complete, the entire `\u003cmodel_name\u003e` folder can be copied from `/var/www/html/models/` to the `models/` directory of your Curator project.\n\nCurator’s web application is built with PHP and is used to collect an OpenSea URL and a desired model from the user. It parses the input to determine the contract address and token ID. A query is made to the [OpenSea API](https://docs.opensea.io/reference/api-overview) to gather the token’s metadata and locate the URL of the NFT’s image. The model name and image URL are passed to `curator.sh` via `shell_exec()`.\n\nThis bash script downloads the NFT’s image and uses it to overwrite `nft.png` for the selected model. When the FBX file is then converted to a [USDZ](https://developer.apple.com/augmented-reality/quick-look/), it will pull the current contents of `nft.png` and generate the USDZ file with the user’s NFT image instead of the placeholder image.\n\nThe generated USDZ model can then be viewed on any iPhone that supports ARKit.\n\n## Deploy container to Heroku\n```\nheroku container:login\nheroku labs:enable --app nftcurator runtime-new-layer-extract\nheroku container:push web --app nftcurator\nheroku container:release web --app nftcurator\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fun1xg0d%2Fcurator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fun1xg0d%2Fcurator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fun1xg0d%2Fcurator/lists"}