Documentation Version: 3.3.0

Website

Nice Sex Tracker

URL Scheme

You can access Nice Tracker via the URL Scheme:

nicetraker://

You can add a new entry by using the add host:

nicetraker://add

URL Parameters

parameter required value description
activities Y string comma delimited, url encoded, list of activities' names
date Y string now or in the format of yyyy-MM-dd-HH-mm
partners string comma delimited, url encoded, list of partners' names
duration integer number of minutes
protection integer 1 = used, 0 = not used
note string url encoded string of a note
icon string name of the entry's icon
location string name of a saved location
latitude decimal latitude of location
longitude decimal longitude of location
orgasms integer number of orgasms

Note: If location is set, then latitude and longitude will be ignored. Note: You can only add partners and activities that currently exist within the app.

URL Examples

Example of adding 5 minutes if sex now

nicetracker://add?activities=sex&date=now&duration=5

Example of adding multiple activities

nicetracker://add?activities=sex,hand%20job,oral&date=2018-04-20-16-20&protection=0&duration=17

JSON Backup

The backup JSON can be used to bulk import or edit your Nice Tracker database.

Backup files will be exported with a name in the format of: nice-data-YYYY-MM-dd-HHmmss.json

Please know that restoring from a backup JSON file, that all existing data will be removed and replaced with the data in the JSON file.

The format of the backup JSON file looks like:

{
    "version":"x.x.x",
    "activities":[
        // array of activity objects
    ],
    "partners":[
        // array of partner objects
    ],
    "locations":[
        // array of location objects
    ],
    "entries":[
        // array of entry objects
    ]
}

Entry JSON Object

parameter required value description
activities Y array of objects array of short activity objects
date Y string now or in the format of yyyy-MM-dd-HH-mm
partners array of objects array of short partner objects
duration integer number of minutes
protection boolean true = used, false = not used
note string note for the entry
icon string name of the entry's icon
location object location object
orgasms integer number of orgasms

Activity JSON Object

parameter required value description
name Y string unique activity name
icon Y string name of icon

Note: The short version of the activity object only includes the name parameter.

Partner JSON Object

parameter required value description
name Y string unique partner name
birthday string DOB in the format of yyyy-MM-dd
sexInt integer 0 = Male, 1 = Female, 2 = Other
image string base64 encoded string of png image data
note string note for the partner

Note: The short version of the partner object only includes the name parameter.

Location JSON Object

parameter required value description
name Y string unique location name
latitude Y decimal valid latitude
longitude Y decimal valid longitude

Note: In an entry object with a custom location that isn't added to the locations, then latitude and longitude parameters will exist, otherwise only the name parameter will exist.

Siri Shortcuts

You can add now add new entries through Siri. You can do this two different ways: Through the built in Nice Sex Tracker shortcut, or through the open URL shortcut.

Nice Tracker Shortcut

Open the Shortcuts app and tap 'Create Shortcut'. Search for the Nice app in the search field and select the New Nice Entry shortcut.

Note: This shortcut only works if you have at least one default activity set inside the app.

Nice Siri Shortcut

URL Shortcut

Open the Shortcuts app and tap 'Create Shortcut'. Then select the 'URL' option under the 'Web' section.

Refer to the URL Scheme Documentation to build your shortcut URL.

Nice Siri Shortcut URL

Add to Siri

After you have created the shortcut, be sure to edit the shortcut options to 'Add to Siri'. You can then record whatever voice phrase to whatever you want, e.g. "I just had sex!".

Add to Siri

Available Icon Names

thong asterisk lips hand
self-hand heart star condom
bra heel cherry hotdog
flower fire boobs vagina
penis woman man orgy
fortune beer wine handcuffs
mountains tent bath strawberry