# Catin

**Repository Path**: eglwang/catin

## Basic Information

- **Project Name**: Catin
- **Description**: Catin 是一个 Python 应用程序，它可以根据一天中的时间更改您的桌面壁纸，就像优雅的 MacOS 所做的那样。目前提供9种壁纸。
Catin is a Python application that changes your desktop wallpaper based on the time of day, just like what MacOS does.
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2024-06-10
- **Last Updated**: 2024-09-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Catin

Catin is a Python application that changes your desktop wallpaper based on the time of day, just like what MacOS does.

## Installation

To install Catin, run the following command:

```sh
./install.sh
```
after installed, Catin will register a user-level service -- located at ~/.config/system/user/catin.service and ~/.config/system/user/catin.timer, use the following commands to start\stop Catin:
```sh
# to start Catin
systemctl --user start catin.timer
# to stop Catin
systemctl --user stop catin.timer
# to enable Catin
systemctl --user enable catin.timer
# to disable Catin
systemctl --user disable catin.timer
```
## Usage

To run Catin, use the following command:

```python
python3 catin.py [theme]
```

Replace \[theme\] with the name of the theme you want to use. The available themes are:

- big-sur-graphic
- bigsur
- catalina
- monterey
- the-beach
- the-cliffs
- the-desert
- the-lake
- ventura

## Uninstallation

To uninstall Catin, run the following command:

```sh
./install.sh -u
```

## Configuration

Catin uses a configuration file (catin.config) to store settings such as the theme, latitude, longitude, UTC offset, and desktop environment. You can manually edit this file to change these settings.

```ini

longitude=<your-longitude> # number, e.g. 39.9062 for Beijing(39°54′24″N, 116°23′51″E)
latitude=<your-latitude> # number, e.g. 116.3912 for Beijing(39°54′24″N,116°23′51″E)
utc_offset=8 # your time zone, 8 for CST
desktop=gnome # only support 'gnome' and 'mate' right now
theme=the-beach # refer above list 
```