Skip to content

Livecountsedit V7 Save Format

RandomPerson3465 edited this page Sep 1, 2024 · 9 revisions

Livecountsedit v7 save format

Table of save versions

Save version Livecountsedit version(s)
1 v7.0.0
2 v7.0.1-2
3 v7.0.3-8
4 v7.0.9
5 v7.0.10-12
6 v7.1.0-2
7 v7.1.3+

Table of save types

Save Type Counter
1 Livecountsedit theme
2 Livecounts.net theme

Save data format

save.allowHTML

boolean - Default false - Introduced in save version 1

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.

save.api

object - Introduced in save version 2

The API settings.

save.api.apiInterval

number - Default 60 - Introduced in save version 2

The amount of time between API checks in seconds. The minimum is 1 and the maximum is (2^31 - 1)/1000.

save.api.leeway

number - Default 10 - Introduced in save version 2

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.

save.api.updater

number - Introduced in save version 2

The interval ID of the API updater, or 0 if there is none. Has no effect when imported.

save.api.ytAPIEnabled

boolean - Default false - Introduced in save version 2

Whether or not YouTube API updates are enabled. Always false in public saves due to the API key being removed.

save.api.ytAPIKey

string - Introduced in save version 2

The YouTube Data API v3 key. Do NOT share it with anyone! Always empty in public saves.

save.api.ytChannelID

string - Introduced in save version 2

The YouTube channel ID of the channel whose subscriber counter is being tracked.

save.counters

array - Introduced in save version 1

save.isFullScreen

boolean - Introduced in save version 7

Only has an effect on the Livecountsedit themed counter. If true, the settings are hidden and the counter expands to fill the width of the screen.

save.lastSaved

number - Introduced in save version 1

The Unix timestamp in milliseconds of when the save was last saved.

save.paused

boolean - Default false - Introduced in save version 1

Whether or not everything is paused.

save.private

boolean - Introduced in save version 2

Whether or not this save is a private save. This must be true to enable allowHTML and to import data such as API keys.

save.project

string - Default livecountsedit - Introduced in save version 6

Always "livecountsedit" for Livecountsedit. Has no effect.

save.saveType

number - Introduced in save version 1

A number that indicates which counter the save was exported from.

save.title

string - Default save - Introduced in save version 1

The file name that is given to the save when exporting.

save.updateInterval

number - Default 2 - Introduced in save version 1

The time between on-screen counter updates in seconds. The minimum is 0.001 and the maximum is (2^31 - 1)/1000.

save.updater

number - Introduced in save version 1

The interval ID of the counter updater, or 0 if there is none. Has no effect when importing.

save.version

number - Introduced in save version 1

The save version, as shown in the table at the top of this page.

counter.chartData

array - Introduced in save version 1

The data of the chart associated with this counter. If counter.settings.keepChartData is false, this data is discarded upon loading.

counter.id

number - Introduced in save version 1

The numeric counter ID.

counter.gain

number - Introduced in save version 1

The amount that the counter gained by in the last update.

counter.lastAPICount

number or null - Introduced in save version 3

The API count from the last time the API was checked, or null if API updates are disabled.

counter.lastUpdated

number - Introduced in save version 3

The Unix timestamp in milliseconds of when the counter was last updated.

counter.leeway

number - Introduced in save version 3

Same as API update overestimation leeway (v7.0.3+)

counter.settings

object - Introduced in save version 1

The counter settings.

counter.settings.abb

boolean - Default false - Introduced in save version 1

Whether or not this counter is abbreviated and shows only three significant figures, as in the YouTube API after 2019.

counter.settings.animationDuration

number - Default 2 - Introduced in save version 1

The duration of the counter's animation. Minimum 0. Set to 0 to disable the animation.

counter.settings.animationType

number - Default 0 - Introduced in save version 1

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. In save versions 5+, 3 makes the odometer transition straight to the new value without going through the digits in between.

counter.settings.bannerBlur

number - Default 4 - Introduced in save version 1

The amount the channel banner is blurred by in pixels.

counter.settings.bannerFile

file - Introduced in save version 1

Used temporarily when the banner image is added using "Choose File." This is converted to a data URI and stored in counter.settings.bannerURL upon loading.

counter.settings.bannerURL

string - Introduced in save version 1

The URL of the banner image.

counter.settings.bgColor

color - Default #000000 (black) - Introduced in save version 1

The background color.

counter.settings.chartColor

color - Default #ff0000 (red) - Introduced in save version 1

The color of the line on the chart.

counter.settings.chartCreditsEnabled

boolean - Default false - Introduced in save version 7

Whether or not to show the "credits" (the text that says "lcedit.com") at the bottom right corner of the chart.

counter.settings.chartGridColor

color - Default #bdbdbd (a light gray) - Introduced in save version 7

Sets the color of the chart's grid, labels, and "credits" text.

counter.settings.count

number - Default 0 - Introduced in save version 1

The internal value of the counter. This is rounded (or abbreviated if abb is true) when displayed.

counter.settings.counterColor

color - Default #000000 (black) - Introduced in save version 1

The default color of the counter.

counter.settings.customRate

string - Introduced in save version 1

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.

counter.settings.downColor

color - Default #000000 (black) - Introduced in save version 1

The color of the counter when it is counting down. Set to the same as counter.settings.counterColor to effectively disable.

counter.settings.font

string - Default Arial, Helvetica, sans-serif - Introduced in save version 4

The custom font for the counter.

counter.settings.fontType

number - Default 5 - Introduced in save version 4

The font setting: 0 = standard font, 1 = serif font, 2 = sans-serif font, 3 = monospace font, 4 = mathematical font as defined by your browser. 5 uses a custom font assuming it is installed on your system. 6 imports a font from Google Fonts.

counter.settings.fontWeight

number - Default 400 - Introduced in save version 4

The font weight. Note that not all font weights are supported on every font. 100 = thin, 200 = extra light, 300 = light, 400 = regular, 500 = medium, 600 = semi-bold, 700 = bold, 800 = extra bold, 900 = black

counter.settings.footer

string - Introduced in save version 1

The footer text of the counter.

counter.settings.footerColor

color - Default #000000 (black) - Introduced in save version 1

The color of the footer text.

counter.settings.gainPer

number - Default 2 - Introduced in save version 1

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.

counter.settings.gainType

number - Default 0 - Introduced in save version 1

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 (Gaussian) distribution with a mean of meanRate and a standard deviation of stdevRate. 2 chooses a value according to the custom distribution given in customRate.

counter.settings.imageFile

file - Introduced in save version 1

Used temporarily when the avatar image is added using "Choose File." This is converted to a data URI and stored in counter.settings.imageURL upon loading.

counter.settings.imageURL

string - Introduced in save version 1

The URL of the avatar image.

counter.settings.keepChartData

boolean - Default false - Introduced in save version 1

Whether or not to keep the chart's data upon reloading.

counter.settings.lcNetSubButton

boolean - Default false - Introduced in save version 6

Only has an effect on Livecounts.net theme. If true, clicking the "Subscribe!" button adds 1 to the count.

counter.settings.max

number - Default 2^53 - 1 - Introduced in save version 1

The value at which the counter is capped at.

counter.settings.maxChartValues

number - Default 450 - Introduced in save version 1

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.

counter.settings.maxRate

number - Default 0 - Introduced in save version 1

The maximum gain rate of the counter, used when counter.settings.gainType is 0 (uniform distribution)

counter.settings.meanRate

number - Default 0 - Introduced in save version 1

The mean gain rate of the counter, used when counter.settings.gainType is 1 (normal distribution)

counter.settings.min

number - Default 0 - Introduced in save version 1

The minimum value the counter can display.

counter.settings.minRate

number - Default 0 - Introduced in save version 1

The minimum gain rate of the counter, used when counter.settings.gainType is 0 (uniform distribution)

counter.settings.numberFormat

string - Default ,ddd - Introduced in save version 5

The number format. ,ddd results in a comma thousands separator, .ddd results in a dot thousands separator, ddd results in a space thousands separator, and d results in no thousands separator.

counter.settings.offlineGains

boolean - Default false - Introduced in save version 3

Whether or not to enable offline gains. Offline gains cause the counter to gain as if it were gaining during the entire time the counter was paused or not open, given that this amount of time is at least ten times the update interval.

counter.settings.reverseAnimation

boolean - Default false - Introduced in save version 5

Whether or not to reverse the direction of the odometer animation

counter.settings.showBanner

boolean - Default false - Introduced in save version 1

Whether or not to show the banner

counter.settings.showChart

boolean - Default false - Introduced in save version 1

Whether or not to show the chart (if there is one, then it will still be updating even when hidden)

counter.settings.showChartGrid

boolean - Default false - Introduced in save version 7

Whether or not to show the chart grid and labels

counter.settings.showFooter

boolean - Default false - Introduced in save version 1

Whether or not to show the footer text

counter.settings.showImage

boolean - Default true - Introduced in save version 1

Whether or not to show the avatar

counter.settings.stdevRate

number - Default 0 - Introduced in save version 1

The standard deviation of the gain rate of the counter, used when counter.settings.gainType is 1 (normal distribution). Minimum 0.

counter.settings.title

string - Default User - Introduced in save version 1

The title of the counter (usually the username)

counter.settings.titleColor

color - Default #000000 (black) - Introduced in save version 1

The color of the counter title

counter.settings.upColor

color - Default #000000 (black) - Introduced in save version 1

The color of the counter when it is counting up. Set to the same as counterColor to effectively disable.

counter.settings.updateProbability

number - Default 100 - Introduced in save version 1

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.

counter.settings.updateInterval

number - Default 2 - Introduced in save version 1

The time in seconds between counter updates. The minimum is 0.001 and the maximum is (2^31 - 1)/1000

Counter Specific Default Settings

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)
chartCreditsEnabled true
counterColor #ffffff (white)
downColor #ffffff
footer Subscribers
footerColor #ffffff
imageURL https://lcedit.com/default.png
showBanner true
showChart true
showChartGrid true
showFooter true
titleColor #ffffff
upColor #ffffff

Livecounts.net counter

JSON Key Default Value
bgColor #d0e4fe (a pale blue)
imageURL https://lcedit.com/default.png
lcNetSubButton true
Clone this wiki locally