### Run Setup in Non-Interactive Mode (Simple)

Source: https://github.com/hydrusnetwork/hydrus/blob/master/docs/running_from_source.md

Execute the setup script in non-interactive mode, choosing the simple installation option.

```bash
/path/to/my/python setup_venv.py -i=s
```

--------------------------------

### Run Setup in Non-Interactive Mode (Advanced)

Source: https://github.com/hydrusnetwork/hydrus/blob/master/docs/running_from_source.md

Execute the setup script in non-interactive mode, choosing the advanced installation option with all defaults.

```bash
/path/to/my/python setup_venv.py -i=a
```

--------------------------------

### Setup venv with Non-Interactive Mode

Source: https://github.com/hydrusnetwork/hydrus/blob/master/docs/old_changelog.html

The setup_venv.py script now accepts an optional -i parameter for non-interactive installs. Use -i=s for simple mode or -i=a for advanced mode with automated yes/no choices.

```python
python setup_venv.py -i=s
```

```python
python setup_venv.py -i=a
```

--------------------------------

### Running Hydrus from Source with Pyenv

Source: https://github.com/hydrusnetwork/hydrus/blob/master/docs/old_changelog.html

The 'running from source' documentation now recommends using pyenv for managing Python versions. This example shows how to install and use a specific Python version with pyenv.

```bash
pyenv install 3.11.5
pyenv local 3.11.5
pip install -r requirements.txt
python -m hydrus
```

--------------------------------

### Running Windows Version in Wine with Bottles

Source: https://github.com/hydrusnetwork/hydrus/blob/master/docs/old_changelog.html

Instructions for running the Windows version of Hydrus in Wine have been updated, with a focus on using Bottles. This example demonstrates a successful setup with ffmpeg and mpv working.

```bash
wine-9.0
```

```bash
wine-11.0
```

--------------------------------

### Setup venv with Userpath Expansion

Source: https://github.com/hydrusnetwork/hydrus/blob/master/docs/old_changelog.html

The setup_venv.py script correctly expands userpath venv paths, ensuring that paths like "~/hydrusvenvs/venv313" resolve to the user's directory.

```python
python setup_venv.py -v=~/hydrusvenvs/venv313
```

--------------------------------

### Run Live Preview Server

Source: https://github.com/hydrusnetwork/hydrus/blob/master/docs/about_docs.md

Start a local development server to preview the documentation. Changes to documentation files will automatically trigger a rebuild and page reload.

```bash
mkdocs serve
```

--------------------------------

### Install PyQt6 and Charts

Source: https://github.com/hydrusnetwork/hydrus/blob/master/docs/running_from_source.md

Install PyQt6 and its charting components into the activated virtual environment. This is an alternative to the default PySide6 if needed.

```bash
python -m pip install pyqt6 pyqt6-charts
```

--------------------------------

### Example Response for Get Pending Counts

Source: https://github.com/hydrusnetwork/hydrus/blob/master/docs/developer_api.md

An example JSON response showing pending content counts for different services, including tag mappings and files.

```json
{
  "services" : "The Services Object",
  "pending_counts" : {
    "ae91919b0ea95c9e636f877f57a69728403b65098238c1a121e5ebf85df3b87e" :  {
      "pending_tag_mappings" : 11564,
      "petitioned_tag_mappings" : 5,
      "pending_tag_siblings" : 2,
      "petitioned_tag_siblings" : 0,
      "pending_tag_parents" : 0,
      "petitioned_tag_parents" : 0
    },
    "3902aabc3c4c89d1b821eaa9c011be3047424fd2f0c086346e84794e08e136b0" :  {
      "pending_tag_mappings" : 0,
      "petitioned_tag_mappings" : 0,
      "pending_tag_siblings" : 0,
      "petitioned_tag_siblings" : 0,
      "pending_tag_parents" : 0,
      "petitioned_tag_parents" : 0
    },
    "e06e1ae35e692d9fe2b83cde1510a11ecf495f51910d580681cd60e6f21fde73" : {
      "pending_files" : 2,
      "petitioned_files" : 0
    }
  }
}
```

--------------------------------

### Execute Setup Script on Linux

Source: https://github.com/hydrusnetwork/hydrus/blob/master/docs/running_from_source.md

Run the setup script from the terminal on Linux. Ensure you do not use sudo.

```bash
./setup_venv.py
```

--------------------------------

### Example Response for Get File Path

Source: https://github.com/hydrusnetwork/hydrus/blob/master/docs/developer_api.md

Example JSON response when retrieving a file's local path, including the path, file type, and size.

```json
{
	"path" : "D:\\hydrus_files\\f7f\\7f30c113810985b69014957c93bc25e8eb4cf3355dae36d8b9d011d8b0cf623a.jpg",
	"filetype" : "image/jpeg",
	"size" : 95237
}
```

--------------------------------

### Example Response for Get Cookies

Source: https://github.com/hydrusnetwork/hydrus/blob/master/docs/developer_api.md

An example of the JSON response when retrieving cookies for a domain. The 'cookies' field is a list of cookie rows, each containing name, value, domain, path, and expiration timestamp.

```json
{
	"cookies" : [
		["__cfduid", "f1bef65041e54e93110a883360bc7e71", ".somebooru.org", "/", 1596223327],
		["pass_hash", "0b0833b797f108e340b315bc5463c324", "somebooru.org", "/", 1585855361],
		["user_id", "123456", "somebooru.org", "/", 1585855361]
	]
}
```

--------------------------------

### Run Setup with Custom Python Interpreter

Source: https://github.com/hydrusnetwork/hydrus/blob/master/docs/running_from_source.md

Use a specific Python interpreter to run the setup script.

```bash
/path/to/my/python setup_venv.py
```

--------------------------------

### Example Response for Get Headers

Source: https://github.com/hydrusnetwork/hydrus/blob/master/docs/developer_api.md

Illustrates the JSON structure returned when fetching custom HTTP headers.

```json
{
  "network_context" : {
    "type" : 2,
    "data" : "somebooru.org"
  },
  "headers" : {
    "User-Agent" : {
      "value" : "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:56.0) Gecko/20100101 Firefox/56.0",
      "approved" : "approved",
      "reason" : "Set by Client API"
    },
    "DNT" : {
      "value" : "1",
      "approved" : "approved",
      "reason" : "Set by Client API"
    }
  }
}
```