DDEV-QR
Overview
This add-on adds a command that encodes DDEV URLs into QR codes.
It uses qrencode to parse a URL string into a QR code that is displayed in the terminal.
This helps reduce errors and frustration when entering URLs on portable devices.
Installation
ddev add-on get ddev/ddev-qr
ddev restart
After installation, make sure to commit the .ddev directory to version control.
Usage
| Command | Description |
|---|---|
ddev qr |
Encodes the primary website. Eg. https://example.ddev.site. Shorthand for ddev qr https. |
ddev qr https |
Encodes the HTTPS version of the primary website. Eg. https://example.ddev.site. |
ddev qr http |
Encodes the HTTP version of the primary website. Eg. http://example.ddev.site. |
ddev qr share |
Tries to find the share tunnel and encodes the random address. |
ddev qr _STRING_ |
Encodes the value of _STRING_. |
Note: Using ddev qr or ddev qr https inside a Gitpod environment will encode the Gitpod-routed DDEV URL instead.
What’s a QR code?
A QR code is a two-dimensional barcode that can store a string of information such as a URL. You can use a QR reader, such as the camera in you mobile phone, to read the image. In the case of a URL, a mobile phone can then visit the URL.
Below is QR code with https://ddev.com encoded.
See Scan QR codes on Camera from Google. See Scan a QR code with your iPhone, iPad, or iPod touch.
Why do I want to use it?
Initially, this addon was created for use with ddev share which (currently) uses ngrok.
When using the free tier service, ngrok generates a random string address to access your website:
Eg. https://124-5da4-96-37-190.ngrok-free.app
This is great but it’s not so fun typing that string on a small keyboard. Instead:
- Use DDEV to share the site:
ddev share - Generate a qr code:
ddev qr share - Scan with code with your phone to visit the site.
Similarly, when using DDEV in Gitpod, DDEV defers to Gitpod’s routing system that also generates random complex strings.
Using ddev qr or ddev qr https inside a Gitpod environment will encode the Gitpod-routed DDEV URL instead. Eg. https://ddev-qrdemo-cksfu15uj8u4.ws-us131.gitpod.io/
Contributing
PR are welcome, especially if they contain working tests.
Credits
Contributed and maintained by @tyler36