Skip to content
Switch branches/tags
Go to file
Cannot retrieve contributors at this time
layout title permalink
Q Applet Packaging & Submission

Once an applet is developed, these simple few steps will get it published in the Q marketplace.

Your app in Q marketplace

Packaging for distribution

To be distributed on the Q marketplace, an applet needs the following files:

  • package.json
  • an icon for the marketplace
  • index.js

The package.json needs to contain the information needed for the Q the marketplace as in the following example:

  "name": "daskeyboard-applet--cpu-usage",
  "displayName": "CPU Usage",
  "version": "1.0.6",
  "description": "Displays CPU usage on a Das Keyboard Q device",
  "longDescription": "Keep an eye on the CPU activity on your Q keyboard!",
  "officialProductName": "CPU Usage",
  "appUrl": "URL of official app if any e.g.: ",
  "isSingleton": true,
  "videoUrl": "",
  "icon": "assets/icon.png",
  "image": "assets/q-cpu-usage.png",
  "publisher": "Das Keyboard",
  "authorName": "Das Keyboard team",
  "authorUrl": "",
  "issuesUrl": "",
  "homePageUrl": "",
  "developerRepoUrl": "",
  "licenseUrl": "",
  "changelogUrl": "",
  "license": "MIT",
  "readMeUrl": "",
  "readMeEndUserUrl": "",
  "main": "index.js",
  "scripts": {
    "start": "node index.js",
    "test": "mocha"
  "engines": {
    "das-keyboard-q": "3.0.0"
  "dependencies": {
    "daskeyboard-applet": "^2.7.12",
    "mocha": "^5.2.0",
    "os-utils": "^0.0.14",
    "request": "^2.88.0"
  "qConfig": {
    "geometry": {
      "width": 10,
      "height": 1,
      "defaults": {
        "origin": {
          "x": 0,
          "y": 1

Submitting an applet to the Q marketplace

Once an applet is publicly accessible on Github, it is easy to submit an applet to the Q market place. Just follow these instructions: