{"id":18230489,"url":"https://github.com/benc-uk/excel-mtg","last_synced_at":"2025-04-08T09:50:30.254Z","repository":{"id":75890981,"uuid":"594812816","full_name":"benc-uk/excel-mtg","owner":"benc-uk","description":"Excel add-in for enriching spreadsheets using Data Types and extracting information about Magic The Gathering cards","archived":false,"fork":false,"pushed_at":"2023-01-30T09:45:32.000Z","size":642,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-02-14T06:46:12.868Z","etag":null,"topics":["api-rest","data-types","excel","magic-the-gathering"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/benc-uk.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":"2023-01-29T18:06:04.000Z","updated_at":"2023-01-30T09:47:24.000Z","dependencies_parsed_at":null,"dependency_job_id":"e9adaf3b-973e-4a86-803b-1f77b031cde4","html_url":"https://github.com/benc-uk/excel-mtg","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/benc-uk%2Fexcel-mtg","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benc-uk%2Fexcel-mtg/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benc-uk%2Fexcel-mtg/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benc-uk%2Fexcel-mtg/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/benc-uk","download_url":"https://codeload.github.com/benc-uk/excel-mtg/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247819947,"owners_count":21001394,"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":["api-rest","data-types","excel","magic-the-gathering"],"created_at":"2024-11-04T11:04:22.132Z","updated_at":"2025-04-08T09:50:30.241Z","avatar_url":"https://github.com/benc-uk.png","language":"TypeScript","readme":"# Magic The Gathering API Excel Add In\n\nThis is an Excel add-in for enriching spreadsheets using Data Types and extracting information about Magic The Gathering cards. It can lookup cards by name\nCreated purely to learn Excel add-in development, this has dubious real world applicability! \n\nIt uses the REST API of https://docs.magicthegathering.io/\n\n![screen 3](./docs/Screenshot%202023-01-30%20093832.png)\n![screen 1](./docs/Screenshot%202023-01-30%20093613.png)\n![screen 2](./docs/Screenshot%202023-01-30%20093758.png)\n\n# Developement with WSL\n\n## Pre-reqs and setup\n\n### From WSL shell/terminal\n\nExcel document URL:\n\n- Copy `.env.sample` to `.env`\n- Edit `.env`\n  - Add the URL of an online Excel document as the value of `DOCUMENT_URL`\n  - To get this URL: Open Office on the web or OneDrive. Using the \"Create\" option, make a document in Excel. In this new document, select \"Share\", select \"Copy Link\", and copy the URL.\n  \nGenerate certs:\n\n- Ensure certs are generated by running `npx office-addin-dev-certs install`\n- Check with `ls -l ~/.office-addin-dev-certs` \n- Edit `webpack.config.js` in root of project and add `host: \"0.0.0.0\",` to the devServer configuration section (around line 97+)\n- Run `npm run dev-server` (also from root of project)\n\n### From Windows\n\n- Open path `\\\\wsl.localhost\\Ubuntu\\home\\{username}\\.office-addin-dev-certs` in file explorer (change the distro and username to match yours)\n- Double click the `ca.crt` file\n  - Click 'Install Certificate'\n  - IMPORTANT: Place the certificate in the \"Current User\" and \"Trusted Root Certification Authorities\" store, do NOT pick automatic\n  - Complete the import process\n- Double click `localhost.crt`\n  - Click 'Install Certificate'\n  - Place the certificate in the \"Current User\" and pick automatic for the store\n  - Complete the import process\n- Open a browser window and navigate to `https://127.0.0.1:3000/manifest.xml` Note. It is critical you use HTTPS and 127.0.0.1 not localhost\n  - The XML file should be shown and you should NOT get any browser or certificate warnings\n\n## Running with Web Sideloading\n\nOnce all the pre-reqs are done\n\n- Make sure the dev server still running, if not start it in a separate terminal with `npm run dev-server`\n- Run `npm run start:web`\n\n# Deploying to Azure\n\nQuick notes:\n\n- Create a new Static Web App `az staticwebapp create -n MyStaticAppName -g MyExistingRg`\n- [Install the SWA CLI](https://azure.github.io/static-web-apps-cli/docs/use/install)\n- Edit `swa-cli.config.json` and change `appName` and `resourceGroup` to match what you have deployed.\n- Run `npm run build`\n- Run `swa deploy --no-use-keychain`\n  \nAdding and using deployed add-in\n\n- Open new Excel web document, https://www.office.com/launch/excel?auth=2 \n- Insert \u003e Add-Ins \u003e Manage My Add-Ins \u003e Upload My Add-In\n- Browse to the `manifest.xml` in the dist folder NOT the one in the repo root\n- Use the new add-in :)","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbenc-uk%2Fexcel-mtg","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbenc-uk%2Fexcel-mtg","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbenc-uk%2Fexcel-mtg/lists"}