Metadata-Version: 2.4
Name: startlive
Version: 1.2.1
Summary: A desktop application for starting Bilibili live streams
License-Expression: GPL-3.0-only AND LicenseRef-StartLive-Artwork
Project-URL: Homepage, https://github.com/Radekyspec/StartLive
Project-URL: Source, https://github.com/Radekyspec/StartLive
Project-URL: Issues, https://github.com/Radekyspec/StartLive/issues
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Environment :: X11 Applications :: Qt
Classifier: Topic :: Multimedia :: Video
Requires-Python: <3.15,>=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: LICENSE-ARTWORK
Requires-Dist: PySide6~=6.11.0
Requires-Dist: pillow~=12.2.0
Requires-Dist: qrcode~=8.2
Requires-Dist: requests[socks]~=2.32.5
Requires-Dist: obsws-python
Requires-Dist: keyring~=25.6.0
Requires-Dist: darkdetect~=0.8.0
Requires-Dist: semver~=3.0.4
Requires-Dist: PyQtDarkTheme-fork~=2.3.6
Requires-Dist: velopack==1.2.0; sys_platform != "linux"
Requires-Dist: cryptography~=49.0.0
Dynamic: license-file

<!-- markdownlint-disable -->
<div align="center">

<img alt="LOGO" src="https://raw.githubusercontent.com/Radekyspec/StartLive/master/docs/images/icon_left.png" width="256" height="256" />

# StartLive

Bypass the requirement to use Bilibili’s official "LiveHime" client to start streaming.

Download / Update / Q&A QQ Group: <a href="https://qm.qq.com/q/fPBktdfdrG">1022778201</a>

<a href="https://github.com/Radekyspec/StartLive/blob/master/docs/README_zh.md">
🇨🇳 简体中文版</a>

</div>
<!-- markdownlint-restore -->

## Disclaimer

- This software is open-sourced under the [GNU General Public License 3.0](https://www.gnu.org/licenses/gpl-3.0.en.html).
- The software **logo is not licensed under GPL-3.0**. All rights are reserved by the artist [花漫酱](https://space.bilibili.com/49468802) and the software developer. You may not claim GPL-3.0 authorization to use the logo without permission, nor use it for any commercial purpose without authorization.

### Download via Releases

Download link: **[Click here to download](https://github.com/Radekyspec/StartLive/releases/latest)**

### Install via Windows Package Manager (winget)

```shell
winget install Radekyspec.StartLive
```

### Install via AUR (Arch Linux/Manjaro)

> Install `startlive-git` using an AUR helper (e.g. `paru`, `yay`, `pikaur`).

```shell
paru -S startlive-git
```

### Install from PyPI

Requires Python 3.11–3.14, a desktop environment and a supported system keyring.

With uv:

```shell
uv tool install startlive
startlive
uv tool upgrade startlive
```

With pip:

```shell
python -m pip install startlive
startlive
python -m pip install --upgrade startlive
```

The `startlive` command works from any directory. Use `startlive --help` for
options and `startlive --version` to check the installed version. Python package
installations use uv/pip for updates. On Windows, configuration and logs are
stored under `%LOCALAPPDATA%/StartLive`; account credentials remain in the
system keyring.

Maintainers: see
the [PyPI publishing guide](https://github.com/Radekyspec/StartLive/blob/master/docs/publishing.md).

Supported Linux installations are managed and updated through the system
package manager. The in-app Velopack updater is disabled on Linux, so Velopack
does not need to be installed separately.

## Screenshots

![2bf8d9d51186e774903b6cd26831f355](https://github.com/user-attachments/assets/974b0dbb-fcd5-4b26-be76-42db728b8942)

## How to Use

**[Open the step-by-step guide (Tencent Docs)](https://docs.qq.com/doc/DTHVMdkhtUWJjRFhv?scene=4edcd4a61e4d506148e0f879bN4Lu1)**

## Run from Source / Development

[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/Radekyspec/StartLive)

### Prerequisites

- `3.11 <= Python <= 3.14`
- Tested on **Python 3.14.6**; **Python 3.12.10** recommended
- Desktop environment
- `PySide6 (Qt for Python)` [supported platforms/architectures](https://wiki.qt.io/Qt_for_Python)
- A keyring backend supported by the [`keyring`](https://pypi.org/project/keyring/) package  
  - On **Windows**: typically the built-in [Windows Credential Locker](https://learn.microsoft.com/en-us/windows/apps/develop/security/credential-locker)  
  - On **macOS**: typically the system `Keychain`  

### Install & Run

Create a virtual environment:

```shell
python -m venv venv
```

- **Windows**: 

```shell
.\venv\Scripts\pip.exe install -e .
.\venv\Scripts\python.exe .\StartLive.py
```

- **macOS / Linux**:

```shell
./venv/bin/pip install -e .
./venv/bin/python ./StartLive.py
```

> Note: Bilibili does **not** enable **HEVC (High Efficiency Video Coding)** streaming for all users. If pushing the stream fails, please check your encoder/codec settings.
