Skip to content

Livecountsedit V7 Save Format

RandomPerson3465 edited this page Jun 19, 2024 · 9 revisions

Livecountsedit v7 save format

Table of save versions

Save version Livecountsedit version(s)
1 v7.0.0
2 v7.0.1

Save data

JSON Key Type Default Value Description
allowHTML boolean false Allows the use of HTML tags in places like the username and footer. This can only be enabled by importing a private save with this set to true. Please use this responsibly.
api object The API settings. (v7.0.1+)
counters array [] The list of counters.
lastSaved number The Unix timestamp in milliseconds of when the save was last saved.
paused boolean false Whether or not everything is paused.
private boolean true Whether or not this save is a private save. This must be true to enable allowHTML and to import data such as API keys.
saveType number A number that indicates which counter the save was exported from. The v7 save format is currently only being used by the Livecountsedit counter, which uses 1.
title string save The file name that is given to the save when exporting.
updateInterval number 2 The time between on-screen counter updates in seconds. The minimum is 0.001 and the maximum is (2^31 - 1)/1000.
updater number 0 The interval ID of the counter updater, or 0 if there is none.
version number The save version, as shown in the table at the top of this page.

API settings (v7.0.1+)

JSON Key Type Default Value Description
apiInterval number 60 The amount of time between API checks in seconds. The minimum is 1 and the maximum is (2^31 - 1)/1000.
leeway number 10 The "overestimation leeway" in percent: If the abbreviated version of the current count is higher than what is given by the API, the count is dropped back down to (100 - leeway) percent of the way between the current API count and the next possible API count rounded down. For example, with count=124M or higher,api=123M,leeway=10 the counter drops to 123.9M. An exception is with leeway=0, which drops the counter to next possible API count - 1 or 123,999,999 in this example. Of course, the minimum value for this setting is 0 and the maximum 100.
updater number 0 The interval ID of the API updater, or 0 if there is none.
ytAPIEnabled boolean false Whether or not YouTube API updates are enabled. Always false in public saves due to the API key being removed.
ytAPIKey string The YouTube Data API v3 key. Do NOT share it with anyone! Always empty in public saves.
ytChannelID string The YouTube channel ID of the channel whose subscriber counter is being tracked.

Counter

JSON Key Type Default Value Description
chartData array [] The data of the chart associated with this counter. If settings.keepChartData is false, this data is discarded upon loading.
id number The numeric counter ID.
gain number 0 The amount that the counter gained by in the last update.
settings object The counter settings.

Counter settings

JSON Key Type Default Value Description
abb boolean false Whether or not this counter is abbreviated and shows only three significant figures, as in the YouTube API after 2019.
animationDuration number 2 The duration of the counter's animation. Minimum 0. Set to 0 to disable the animation.
animationType number 0 The animation setting: 0 is the default odometer animation, 1 is the YouTube Studio odometer animation, and 2 disables the odometer animation and makes the number count to the new value.
bannerBlur number 4 The amount the channel banner is blurred by in pixels.
bannerFile file Used temporarily when the banner image is added using "Choose File." This is converted to a data URI and stored in bannerURL upon loading.
bannerURL string The URL of the banner image.
bgColor color #000000 (black) The background color.
chartColor color #ff0000 (red) The color of the line on the chart.
count number 0 The internal value of the counter. This is rounded (or abbreviated if abb is true) when displayed.
counterColor color #000000 The default color of the counter.
customRate string The custom distribution setting, where each line has the form of Min,Max,Weight, where Min is the minimum gain, Max is the maximum gain, and Weight is the relative probability of choosing this category. For example: 123,456,1 and 69,420,2 on a new line will cause the counter to gain a random amount from 123 to 456 a third of the time, and a random amount from 69 to 420 two thirds of the time.
downColor color #000000 The color of the counter when it is counting down. Set to the same as counterColor to effectively disable.
footer string The footer text of the counter.
footerColor color #000000 The color of the footer text.
gainPer number 2 The amount of time in seconds the counters gain per. Default 2, which makes the gain rates in per default 2 second update interval. Set to 1 for gains in per second, 60 for gains in per minute, and 3600 for gains in per hour. Minimum 0.001.
gainType number 0 A number corresponding to the method that random numbers are chosen for updating the counter. 0 chooses a random value from minRate to maxRate for the gain uniformly. 1 chooses a value according to a normal distribution with a mean of meanRate and a standard deviation of stdevRate. 2 chooses a value according to the custom distribution given in customRate.
imageFile file Used temporarily when the avatar image is added using "Choose File." This is converted to a data URI and stored in imageURL upon loading.
imageURL string The URL of the avatar image.
keepChartData boolean false Whether or not to keep the chart's data upon reloading.
max number 2^53 - 1 The value at which the counter is capped at.
maxChartValues number 450 The maximum number of data points stored in the chart. Default 450, which with the default 2 second update interval shows data for the past 15 minutes.
maxRate number 0 The maximum gain rate of the counter, used when gainType is 0 (uniform distribution)
meanRate number 0 The mean gain rate of the counter, used when gainType is 1 (normal distribution)
min number 0 The minimum value the counter can display.
minRate number 0 The minimum gain rate of the counter, used when gainType is 0 (uniform distribution)
showBanner boolean false Whether or not to show the banner
showChart boolean false Whether or not to show the chart (if there is one, then it will still be updating even when hidden)
showFooter boolean false Whether or not to show the footer text
showImage boolean true Whether or not to show the avatar
stdevRate number 0 The standard deviation of the gain rate of the counter, used when gainType is 1 (normal distribution). Minimum 0.
title string User The title of the counter (usually the username)
titleColor color #000000 The color of the title
upColor color #000000 The color of the counter when it is counting up. Set to the same as counterColor to effectively disable.
updateProbability number 100 The percent chance that the counter will update during each update interval. Can be used to "randomize" the update interval. If a counter is updated, its gains are scaled by 100 / probability in percent to match the intended gain rates. Of course, the minimum value for this setting is 0 and the maximum 100.
updateInterval number 2 The time in seconds between counter updates. The minimum is 0.001 and the maximum is (2^31 - 1)/1000

Counter Specific Defaults

Some counters have defaults different from the regular defaults.

Livecountsedit counter

JSON Key Default Value
bannerURL https://lcedit.com/default_banner.png
bgColor #222233 (a dark blue)
counterColor #ffffff (white)
downColor #ffffff
footer Subscribers
footerColor #ffffff
imageURL https://lcedit.com/default.png
showBanner true
showChart true
showFooter true
titleColor #ffffff
upColor #ffffff
Clone this wiki locally