# URL Params for LVP _(Library Viewer/Player)_

> ### What is URL params?
> ### - URL params is options that are applied & set to current website session by URL
> **Example: `/ceo?as-good-as-it-gets` or `/ceo?as-good-as-it-gets&play=it-doesn-t-get-any-better-than-this` for advanced params**
### Advanced params are added after the album: `?{album name}&{param}`

## List of advanced params:
| Param | What it does | Needs album? |
|---|---|---|
| `&play={song name}` | **play song of album on when page opens** | **yes** |
| `&fullscreen` | **open song in fullscreen lyrics mode when song is played** | with `&play` |
| `&safe` | **turns on censoring for lyrics** | no |
| `&action={action}` | **launch a specific action when the page opens** | depends on action |

### How each param works:
### All of following advanced params require album param to exist: `?{album name}` _(on subdomains for redirect `?` is not needed)_
## List of advanced params:
- `&play={song name}` - **play song of album on when page opens, `{song}` should be replaced with song name on the album** _(for words like doesn't, `'` is defined as a space, so `doesn't` would be `doesn-t`)_. Singles work the same way - a single is just a one-track album, so `&play={song name}` matches its track like any other.
- `&play={track number}` - **plays the track at that position on the album**, e.g. `&play=3` plays the 3rd track _(zero padded works too: `&play=03`; a version can be added: `&play=3[v2]` targets track 3 only as the v2 take)**. Digits are always a position, never a name - `&play=1` won't match a title that just contains a `1`.
- `&fullscreen` - **open song in fullscreen lyrics mode when song is played**. Requires `&play` to work
- `&safe` - **turns on censoring for lyrics** _(enables feature censor, which replaced controversial words (like nazi and etc) with ***)_
- `&action` - **runs action set from URL as page opens**

## Actions list (`&action`):
| Action | What it does                                | Requires album specification |
|---|---------------------------------------------|------------------------------|
| `search` | **opens the search bar**                    | false                        |
| `vinyl` | **opens the vinyl view of the album ** | true                         |
| `conf` | **open the conf**                           | false                        |

> ### Examples
> - `https://ye.yzyworks.com/bully&play=40-nights` - **plays song "40 NIGHTS" from album "BULLY"** _(artist dir YZY)_
> - `https://ye.yzyworks.com/cuck&play=cosby&fullscreen=true&safe` - **plays "COSBY" from album "CUCK" in fullscreen mode with censored lyrics on** _(artist dir YZY)_
> - `https://ye.yzyworks.com/gemini-season&play=gemini-season` - **plays "GEMINI SEASON"** _(artist dir YZY)_
> - `https://ye.yzyworks.com/bully&play=1` - **plays 1st song "40 NIGHTS" from album "BULLY"** _(artist dir YZY)_
> - `https://ceo.yzyworks.com/as-good-as-it-gets&play=microdose` - **play "microdose" from album "as good as it gets" with fullscreen mode** _(artist dir ceo)_
> - `https://ye.yzyworks.com/?action=search` - **opens the search bar immediately** _(artist dir YZY)_
> - `https://ye.yzyworks.com/bully&action=vinyl` - **opens vinyl view of "BULLY" immediately** _(artist dir YZY)_
> - `https://ye.yzyworks.com/YZY?action=conf&safe` - **opens with the conf unminimized** _(artist dir YZY)_

> ### Subdomains:
> - `ye.yzyworks.com`: redirects to `/YZY`, URL params supported
> - `ceo.yzyworks.com`: redirects to `/ceo`, URL params supported
> 
> - _not included trackers are only available by subdir path, listed in **Trackers**  in footer in any of trackers_

### Share Song
Right-click on any track in album view → **Share Song** gives the short link of that exact song: `https://ye.yzyworks.com/{album}&play={song name}` _(same params as above, so the link plays the song on open)_.
- versioned tracks share as `&play={song name}[vN]` so the link opens that exact take, not the first song with the same name
- on phone it opens the share sheet, elsewhere the link is copied to clipboard

Works for: LVP v147 and higher