URL Scheme

You can access Nice Tracker via the URL Scheme:

nicetracker://

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

nicetracker://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
`partnerOrgasms`		integer	number of partner orgasms
`rating`		integer	rating score 1-5
`tags`		string	comma delimited, url encoded, list of tags' names

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 of 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
    ],
    "tests":[
        // array of std/sti test objects
    ],
    "tags":[
        // array of tag 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
`partnerOrgasms`		integer	number of partner orgasms
`rating`		integer	rating 1-5
`tags`		array of objects	array of tag objects

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
`phone`		string	string representation of a phone number
`std`		string	comma delimited, url encoded, list of STDs/STIs
`tests`		string	array of test json objects
`tags`		array of objects	array of tag objects

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.

Pregnancy/STD/STI Test JSON Object

parameter	required	value	description
`testDate`	Y	string	date in the format of `yyyy-MM-dd`
`result`	Y	boolean	`true` or `false`
`std`	Y	string	comma delimited, url encoded, list of STDs/STIs

Tag JSON Object

parameter	required	value	description
`name`	Y	string	unique name of tag

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
foot	goo	rope	briefs
dice	present	mask	sun
moon	butt	plug	exclamation

Docs

Version: 4.9.1

Last Updated: 2023-01-01