# solidtime desktop

<img width="1600" alt="Solidtime Desktop App Demo" src="https://github.com/user-attachments/assets/5b1f801c-bbd6-4b93-9d4a-8c229466403e">

Desktop Application for Solidtime - The modern open-source time-tracker for macOS, Windows and Linux.

> [!WARNING]
> This client is currently in beta, if you run into any problems please open an issue.

Download the latest versions:

-   mac OS (Silicon): [Download](https://github.com/solidtime-io/solidtime-desktop/releases/latest/download/solidtime-arm64.dmg)
-   mac OS (Intel): [Download](https://github.com/solidtime-io/solidtime-desktop/releases/latest/download/solidtime-x64.dmg)
-   Windows (ARM): [Download](https://github.com/solidtime-io/solidtime-desktop/releases/latest/download/solidtime-setup-arm64.exe)
-   Windows (x64): [Download](https://github.com/solidtime-io/solidtime-desktop/releases/latest/download/solidtime-setup-x64.exe)
-   Linux (deb, ARM): [Download](https://github.com/solidtime-io/solidtime-desktop/releases/latest/download/solidtime-arm64.deb)
-   Linux (deb, x86): [Download](https://github.com/solidtime-io/solidtime-desktop/releases/latest/download/solidtime-amd64.deb)
-   Linux (RPM, ARM): [Download](https://github.com/solidtime-io/solidtime-desktop/releases/latest/download/solidtime-aarch64.rpm)
-   Linux (RPM, x86): [Download](https://github.com/solidtime-io/solidtime-desktop/releases/latest/download/solidtime-x86_64.rpm)
-   Linux (tar.gz, ARM): [Download](https://github.com/solidtime-io/solidtime-desktop/releases/latest/download/solidtime-arm64.tar.gz)
-   Linux (tar.gz, x86): [Download](https://github.com/solidtime-io/solidtime-desktop/releases/latest/download/solidtime-x64.tar.gz)

You can find the latest versions [here](https://github.com/solidtime-io/solidtime-desktop/releases)

Additionally you can install the app via

<a href="https://snapcraft.io/solidtime">
  <img alt="Get it from the Snap Store" src="https://snapcraft.io/static/images/badges/en/snap-store-white.svg" />
</a>

## Self-Hosted Setup Instructions

If you are using a self-hosted instance you have to make sure to enable the Desktop client access: [Guide](https://docs.solidtime.io/self-hosting/guides/docker#9-activate-desktop-client-access-optional)

For [solidtime Cloud](http://app.solidtime.io/) users this is already configured, no additional step needed. 

## Development Setup

**We do not accept any external contributions at the moment as this project is still in an early stage.**

### Install

```bash
$ npm install
```

### Development

```bash
$ npm run dev
```

### Build

```bash
# For windows
$ npm run build:win

# For macOS
$ npm run build:mac

# For Linux
$ npm run build:linux
```


## Contributing

Please open an issue or start a discussion and wait for approval before submitting a pull request. This does not apply to tiny fixes or changes however, please keep in mind that we might not merge PRs for various reasons. 

**If you submit an AI slop pull request without following the above-mentioned procedure, you will be banned from future contributions to solidtime.**

To keep that manageable, pull requests from authors who are not vouched are closed automatically, unless they change 50 lines or fewer. To get vouched, open an issue or discussion first and explain how you intend to implement the change. Once we have agreed on the approach, we vouch for you. The list lives in [.github/VOUCHED.td](./.github/VOUCHED.td), see [Vouched contributors](https://github.com/solidtime-io/solidtime/blob/main/CONTRIBUTING.md#vouched-contributors) for details.

Please read the [CONTRIBUTING.md](https://github.com/solidtime-io/solidtime/blob/main/CONTRIBUTING.md) before sumbitting a Pull Request.

## Security

Looking to report a vulnerability? Please refer our [SECURITY.md](./SECURITY.md) file.

## License

This project is open-source and available under the GNU Affero General Public License v3.0 (AGPL v3). Please see the [license file](LICENSE.md) for more information.