{"id":19303199,"url":"https://github.com/argentini/argentini.namecheap","last_synced_at":"2026-05-18T17:05:02.251Z","repository":{"id":47300726,"uuid":"515682592","full_name":"argentini/Argentini.NameCheap","owner":"argentini","description":"CLI for adding and removing DNS TXT records using the NameCheap API (e.g. using win-acme). Created for wildcard certificate creation with Let's Encrypt using Win-Acme (Windows, macOS, Linux, .NET 8.0, x64, Arm64, Apple Silicon).","archived":false,"fork":false,"pushed_at":"2024-05-15T22:30:52.000Z","size":28,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-01-05T23:27:56.881Z","etag":null,"topics":["certificates","cli","cli-app","dotnet","letsencrypt","ssl","tls","win-acme"],"latest_commit_sha":null,"homepage":"https://nonsequiturs.com/","language":"C#","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/argentini.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"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}},"created_at":"2022-07-19T17:33:42.000Z","updated_at":"2024-05-15T22:30:55.000Z","dependencies_parsed_at":"2025-01-05T23:37:42.150Z","dependency_job_id":null,"html_url":"https://github.com/argentini/Argentini.NameCheap","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/argentini%2FArgentini.NameCheap","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/argentini%2FArgentini.NameCheap/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/argentini%2FArgentini.NameCheap/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/argentini%2FArgentini.NameCheap/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/argentini","download_url":"https://codeload.github.com/argentini/Argentini.NameCheap/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240404687,"owners_count":19796062,"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":["certificates","cli","cli-app","dotnet","letsencrypt","ssl","tls","win-acme"],"created_at":"2024-11-09T23:25:25.651Z","updated_at":"2026-05-18T17:04:57.212Z","avatar_url":"https://github.com/argentini.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Argentini.NameCheap\n\nThis .NET project builds a command line interface (CLI) application that can add and remove text records using the NameCheap API.\n\nIt was originally built to allow for creating wildcard TLS certificates using *win-acme* (Let's Encrypt) on an IIS server. Creating wildcard certificates with *win-acme* requires DNS host validation. This application can be used with the *win-acme* script feature to allow it to communicate with the NameCheap API and create/delete TXT records that will validate domain ownership.\n\n**This tool does not support the complete NameCheap API.** But it does handle the challenging task of adding and removing text records. Why is this challenging? The NameCheap API does not have functions to add or remove individual records, so the entire set of records must be downloaded, modified, and sent back.\n\n## How to Install\n\nDownload the project and publish it from the root project folder as below.\n\n```\ndotnet publish Argentini.NameCheap/Argentini.NameCheap.csproj -o publish -p:PublishSingleFile=true -c Release -r win-x64 --self-contained\n```\n\nIn the publish folder, edit the `appsettings.json` file and supply your own values.\n\n```json\n{\n    \"NameCheap\": {\n\n        \"ApiKey\": \"{your namecheap API key}\",\n        \"UserName\": \"{your namecheap username}\",\n        \"ApiUserName\": \"{your namecheap API username}\",\n        \"ClientIP\": \"{a whitelisted IPv4 address}\"\n    }\n}\n```\n\n### Note:\n\n* You can enable the NameCheap API and get a key on their [website](https://www.namecheap.com/support/api/intro/).\n* *UserName* and *ApiUserName* are usually the same value, and it is usually the user name you use to sign in to NameCheap.\n* *ClientIP* is a whitelisted IP address allowed to connect to the API. These whitelisted addresses can be added to NameCheap when/where you enable the API on their website. **Note:** API calls will check your current WAN IP with the one you provide in the settings. So they need to match.\n\nOnce the `appsettings.json` file is modified, put the contents of the publish folder on your server and you should be able to use the executable with *win-acme* or any other tool by calling it with a fully qualified path.\n\n## Usage\n\nThe command line is in the format below:\n\n```bash\nArgentini.NameCheap.exe [create|delete] [hostname] [name] [value]\n```\n\nSome examples include:\n\n```bash\nArgentini.NameCheap.exe create example.com * testrecord=yaddayadda\nArgentini.NameCheap.exe create example.com my.api mykey=yaddayadda\nArgentini.NameCheap.exe create example.com my.txt \"val1=yadda; val2=yadda\"\n```\n\nSo in `win-acme` you would set your create script arguments to this:\n\n```\ncreate {ZoneName} {NodeName} {Token}\n```\n\nLikewise, your delete script arguments would be:\n\n```\ndelete {ZoneName} {NodeName} {Token}\n```\n\n### macOS and Linux\n\nThe tool can be used on Linux or macOS as well. If the published executable doesn't run on macOS you may need to manually sign the published application using something like this:\n\n```bash\ncd publish\ncodesign -s - Argentini.NameCheap\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fargentini%2Fargentini.namecheap","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fargentini%2Fargentini.namecheap","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fargentini%2Fargentini.namecheap/lists"}