Metadata-Version: 2.1
Name: dotify
Version: 1.1.0
Summary: 🐍🎶 Yet another Spotify Web API Python library
Home-page: https://the-dotify-project.github.io/dotify
License: MIT
Author: billsioros
Author-email: billsioros97@gmail.com
Requires-Python: >=3.7,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Dist: cached-property (>=1.5.2,<2.0.0)
Requires-Dist: moviepy
Requires-Dist: mutagen
Requires-Dist: python-jsonschema-objects
Requires-Dist: pytube
Requires-Dist: requests
Requires-Dist: spotipy
Requires-Dist: youtube-search-python
Project-URL: Bug Tracker, https://github.com/the-dotify-project/dotify/issues
Project-URL: Changelog, https://github.com/the-dotify-project/dotify/releases
Project-URL: Documentation, https://the-dotify-project.github.io/dotify
Project-URL: Repository, https://github.com/the-dotify-project/dotify
Description-Content-Type: text/markdown

![Dotify](https://raw.githubusercontent.com/the-dotify-project/dotify/master/docs/img/logo.png)

<p align="center">
  <a href="https://www.python.org/">
    <img
      src="https://img.shields.io/pypi/pyversions/dotify"
      alt="PyPI - Python Version"
    />
  </a>
  <a href="https://pypi.org/project/dotify/">
    <img
      src="https://img.shields.io/pypi/v/dotify"
      alt="PyPI"
    />
  </a>
  <a href="https://github.com/the-dotify-project/dotify/actions/workflows/ci.yml">
    <img
      src="https://github.com/the-dotify-project/dotify/actions/workflows/ci.yml/badge.svg"
      alt="CI"
    />
  </a>
  <a href="https://the-dotify-project.github.io/dotify/">
    <img
      src="https://github.com/the-dotify-project/dotify/actions/workflows/docs.yml/badge.svg"
      alt="docs"
    />
  </a>
  <a href="https://codeclimate.com/github/billsioros/dotify/maintainability">
    <img
      src="https://api.codeclimate.com/v1/badges/573685a448c6422d49de/maintainability"
      alt="Maintainability"
    />
  </a>
  <a href="https://codeclimate.com/github/billsioros/dotify/test_coverage">
    <img
      src="https://api.codeclimate.com/v1/badges/573685a448c6422d49de/test_coverage"
      alt="Test Coverage"
    />
  </a>
  <a href="https://opensource.org/licenses/MIT">
    <img
      src="https://img.shields.io/pypi/l/dotify"
      alt="PyPI - License"
    />
  </a>
  <a href="https://github.com/the-dotify-project/dotify/commits">
    <img
      src="https://img.shields.io/github/commits-since/the-dotify-project/dotify/latest?style=flat-square"
      alt="GitHub commits since latest release (by SemVer)"
    />
  </a>
</p>

> _🚧 The project is currently under heavy development 🚧_

## Example Usage

```python
>>> from dotify import Dotify, Track
>>> with Dotify(SPOTIFY_ID, SPOTIFY_SECRET):
>>>     result = next(Track.search("SAINt JHN 5 Thousand Singles", limit=1))
>>> result
<Track "SAINt JHN - 5 Thousand Singles">
>>> result.url
'https://open.spotify.com/track/0fFWxRZGKR7HDW2xBMOZgW'
>>> result.download("SAINt JHN - 5 Thousand Singles.mp3")
PosixPath('SAINt JHN - 5 Thousand Singles.mp3')
```

Feel free to check the [examples](https://github.com/the-dotify-project/dotify/tree/master/examples) folder for more use cases!

## Features

- Searching for
  - Tracks
  - Playlists
  - Albums
- Downloading
  - Tracks
  - Playlists
  - Albums

## Documentation

The project's documentation can be found [here](https://the-dotify-project.github.io/dotify/).

## Installation

```bash
pip install dotify
```

## Contributing

If you would like to contribute to the project, please go through the [Contributing Guidelines](https://the-dotify-project.github.io/dotify/CONTRIBUTING/) first.

## Contributors ✨

Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):

<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
<!-- prettier-ignore-start -->
<!-- markdownlint-disable -->
<table>
  <tr>
    <td align="center"><a href="https://www.linkedin.com/in/vasileios-sioros/"><img src="https://avatars.githubusercontent.com/u/33862937?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Vasilis Sioros</b></sub></a><br /><a href="#maintenance-billsioros" title="Maintenance">🚧</a> <a href="#projectManagement-billsioros" title="Project Management">📆</a> <a href="https://github.com/billsioros/dotify/commits?author=billsioros" title="Documentation">📖</a></td>
  </tr>
</table>

<!-- markdownlint-restore -->
<!-- prettier-ignore-end -->

<!-- ALL-CONTRIBUTORS-LIST:END -->

This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!

