Metadata-Version: 2.1
Name: monthify
Version: 0.3.3
Summary: Sorts liked spotify tracks into playlists by the month they were liked.
Author: Madiba Hudson-Quansah
Author-email: mhquansah@gmail.com
Requires-Python: >=3.10,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Dist: appdirs (>=1.4.4,<2.0.0)
Requires-Dist: cachetools (>=5.2.1,<6.0.0)
Requires-Dist: loguru (>=0.6.0,<0.7.0)
Requires-Dist: rich (>=13.1.0,<14.0.0)
Requires-Dist: spotipy (>=2.22.0,<3.0.0)
Requires-Dist: toml (>=0.10.2,<0.11.0)
Description-Content-Type: text/markdown

# Monthify

A python script that sorts the user's liked Spotify tracks into playlists by the month they were liked.
Inspired by an [IFTTT applet](https://ifttt.com/applets/rC5QtGu6-add-saved-songs-to-a-monthly-playlist) by user [t00r](https://ifttt.com/p/t00r)

## Requirements

- Python 3.10+
- A spotify account
- [Spotify Client_id and Client_secret](https://developer.spotify.com/documentation/general/guides/authorization/app-settings/)

## Install

```
pip install monthify
```

## Usage

```
monthify --client-id=CLIENT_ID --client-secret=CLIENT_SECRET --options
```

Or with a configuration file

```
monthify --options
```

## Configuration

Monthify will look for a monthify.toml file in

Linux

```
~/.config/monthify/
```

Windows

```
C:\Users\username\AppData\Local\Monthify
```

Mac OS

```
/Users/username/Library/Application Support/Monthify
```

<br>
Your monthify.toml file should look like this

```toml
CLIENT_SECRET="..."
CLIENT_ID="..."
```

## Building

### Required

- [Poetry](https://python-poetry.org)

```
git clone https://github.com/madstone0-0/monthify.git
cd monthify
poetry install
poetry build
```

