mycroft.conf

Search…
mycroft.conf
A configuration file that contains the device and service settings.
See a list of all variables available within mycroft.conf​
What is mycroft.conf?
mycroft.conf is a JSON-formatted file that is saved locally on your Mycroft Device, such as Picroft or Mark 1. The mycroft.conf file contains information about the Device itself, like what type of Device and Enclosure it is, as well as information about user preferences. If you haven't specified preferences, then mycroft.conf will contain some default values. Your Device, and Skills installed on your Device, use mycroft.conf to provide additional functionality.
You can edit your mycroft.conf files directly however be very aware that any small syntax error such as a missing comma will prevent the file from being read entirely. In these instances Mycroft may discard the file entirely and generate a fresh copy.
It is recommended to instead use the Mycroft Configuration Manager to make these changes.
Configuration Manager
Where are the mycroft.conf files stored?
The mycroft.conf files are stored in four possible locations:
1.Default - mycroft-core/mycroft/configuration/mycroft.conf
2.Remote (from Home.Mycroft.ai) - /var/tmp/mycroft_web_cache.json
3.System - /etc/mycroft/mycroft.conf
4.User - $HOME/.mycroft/mycroft.conf
Mycroft implements an order of precedence; settings defined at a User level override those at a System level. If the file does not exist, Mycroft moves to the following level.
A look at the inside of mycroft.conf
Here is an example System level mycroft.conf from a Mark 1 Device:
1
[email protected]_1:/etc/mycroft $ cat mycroft.conf
2
{
3
  "enclosure": {
4
    "platform": "mycroft_mark_1",
5
    "platform_build": 9,
6
    "port": "/dev/ttyAMA0",
7
    "rate": 9600,
8
    "timeout": 5,
9
    "update": true,
10
    "test": false
11
  },
12
  "VolumeSkill": {
13
    "default_level": 6,
14
    "min_volume": 0,
15
    "max_volume": 83
16
  }
17
}
Copied!
See a list of all variables available within mycroft.conf``
mycroft_web_cache.json
mycroft_web_cache.json is is a JSON-formatted file that is saved locally on your Mycroft Device, such as Picroft or Mark 1. mycroft_web_cache.json is a cached copy of the settings on your home.mycroft.ai account, such as your Location (which determines Time Zone), which Voice you have selected and your preference for Measurements such as temperature and distance.
Both of these files are regularly used in troubleshooting, so it's useful to know what information they hold, and where they are stored on your Device.
Where is the mycroft_web_cache.json file stored?
This file is stored at:
/var/tmp/mycroft_web_cache.json
on the Device.
How is mycroft_web_cache.json updated?
When you update settings at home.mycroft.ai, your Device will periodically pull them down. In normal circumstances any change should be reflected on the device within 1-2 minutes. You can also instruct your device to pull down the latest configuration, by saying:
Hey Mycroft, update configuration
Mycroft will respond in one of two ways:
If your configuration was out of date, and has been pulled down again, Mycroft will respond:
Configuration updated
If your configuration was the same on your device as on home.mycroft.ai, Mycroft will respond:
Your device has been configured
Reading values directly from mycroft_web_cache.json
To see the city location value:
jq ".location.city" < /var/tmp/mycroft_web_cache.json
To see the latitude and longitude coordinates of your location:
jq ".location.coordinate" < /var/tmp/mycroft_web_cache.json
To see the timezone setting:
jq ".location.timezone" < /var/tmp/mycroft_web_cache.json
To see the listener setting:
jq ".listener" < /var/tmp/mycroft_web_cache.json
To see the Speech to Text (STT) settings:
jq ".stt" < /var/tmp/mycroft_web_cache.json
To see the Text to Speech (TTS) settings:
jq ".tts" < /var/tmp/mycroft_web_cache.json
A look at the inside of mycroft_web_cache.json
Here is an example mycroft_web_cache.json.
NOTE: Your settings will be different.
1
{
2
  "date_format": "DMY",
3
  "tts": {
4
    "google": {
5
      "created_at": 1504481866992,
6
      "updated_at": 1514794901075
7
    },
8
    "module": "mimic",
9
    "fatts": {
10
      "created_at": 1504481866991,
11
      "updated_at": 1514794900939
12
    },
13
    "mimic": {
14
      "created_at": 1504481866989,
15
      "voice": "ap",
16
      "updated_at": 1514794900809
17
    },
18
    "espeak": {
19
      "created_at": 1504481866987,
20
      "updated_at": 1514794900679
21
    },
22
    "marytts": {
23
      "created_at": 1504481866986,
24
      "updated_at": 1514794900548
25
    }
26
  },
27
  "opt_in": true,
28
  "created_at": 1504481866955,
29
  "updated_at": 1514794898083,
30
  "listener": {
31
    "energy_ratio": 1.5,
32
    "created_at": 1504481866996,
33
    "updated_at": 1514794901398,
34
    "channels": 1,
35
    "sample_rate": 16000,
36
    "multiplier": 1,
37
    "threshold": 1e-90,
38
    "phonemes": "HH EY . M AY K R AO F T",
39
    "wake_word": "hey mycroft"
40
  },
41
  "time_format": "full",
42
  "skills": {
43
    "directory": "~/.mycroft/skills",
44
    "created_at": 1504481866994,
45
    "updated_at": 1514794901226,
46
    "stop_threshold": 2
47
  },
48
  "stt": {
49
    "google": {
50
      "credential": {
51
        "created_at": 1504481866970,
52
        "updated_at": 1514794899383
53
      },
54
      "created_at": 1504481866970,
55
      "updated_at": 1514794898989
56
    },
57
    "ibm": {
58
      "credential": {
59
        "created_at": 1504481866958,
60
        "updated_at": 1514794898334
61
      },
62
      "created_at": 1504481866958,
63
      "updated_at": 1514794898218
64
    },
65
    "mycroft": {
66
      "credential": {
67
        "created_at": 1504481866965,
68
        "updated_at": 1514794898856
69
      },
70
      "created_at": 1504481866965,
71
      "updated_at": 1514794898469
72
    },
73
    "module": "mycroft",
74
    "wit": {
75
      "credential": {
76
        "created_at": 1504481866981,
77
        "updated_at": 1514794900417
78
      },
79
      "created_at": 1504481866981,
80
      "updated_at": 1514794900031
81
    },
82
    "openstt": {
83
      "credential": {
84
        "created_at": 1504481866976,
85
        "updated_at": 1514794899900
86
      },
87
      "created_at": 1504481866976,
88
      "updated_at": 1514794899521
89
    }
90
  },
91
  "location": {
92
    "coordinate": {
93
      "latitude": -38.149918,
94
      "created_at": 1504500674753,
95
      "updated_at": 1504500674753,
96
      "longitude": 144.361719
97
    },
98
    "city": {
99
      "created_at": 1504500674710,
100
      "state": {
101
        "country": {
102
          "created_at": 1486125571309,
103
          "code": "AU",
104
          "name": "Australia",
105
          "updated_at": 1486125571309
106
        },
107
        "created_at": 1489950675941,
108
        "code": "VIC",
109
        "name": "Victoria",
110
        "updated_at": 1489950675941
111
      },
112
      "code": "Newtown",
113
      "name": "Newtown",
114
      "updated_at": 1504500674710
115
    },
116
    "created_at": 1504500674709,
117
    "updated_at": 1504500674709,
118
    "timezone": {
119
      "code": "Australia/Melbourne",
120
      "name": "Australian Eastern Standard Time (Victoria)",
121
      "dst_offset": 3600000,
122
      "created_at": 1489950676105,
123
      "updated_at": 1489950676105,
124
      "offset": 36000000
125
    }
126
  },
127
  "enclosure": {
128
    "created_at": 1504481866997,
129
    "rate": 9600,
130
    "updated_at": 1514794901541,
131
    "timeout": 5,
132
    "port": "/dev/ttyAMA0"
133
  },
134
  "system_unit": "metric"
135
}
Copied!