Mixonomer/README.md

[Mixonomer](https://mixonomer.sarsoo.xyz)
==================

![Python Tests](https://github.com/sarsoo/Mixonomer/workflows/test%20and%20deploy/badge.svg)

Set of utility tools for Spotify and Last.fm. 
Built on my other libraries for Spotify ([spotframework](https://github.com/Sarsoo/spotframework)), Last.fm ([fmframework](https://github.com/Sarsoo/pyfmframework)) and interfacing utility tools for the two ([spotfm](https://github.com/Sarsoo/pyfmframework)). Currently running on a suite of Google Cloud Platform services. An iOS client is currently under development [here](https://github.com/Sarsoo/Mixonomer-iOS).

Read the full documentation [here](https://docs.mixonomer.sarsoo.xyz).

# Smart Playlists

Create smart playlists for Spotify including tracks from playlists, library and Spotify recommendations.

![Playlists List](docs/Playlists.png)
![Playlist Example](docs/PlaylistExample.png)

Playlists can pull tracks from multiple sources with some extra ones based on the playlist's type.

* Spotify playlists 
    - Currently referenced by case-sensitive names of those followed by the user
    - Plan to include reference by Spotify URI
* Other Mixonomer playlists
    - Dynamically include the Spotify playlists of other managed playlists
    - Used to allow hierarchy playlists such as for genre (as seen above for multiple rap playlists)
* Spotify Library Tracks
* Monthly Playlists
    - ONLY for "Recents" type playlists
    - Find user playlists by name in the format "month year" e.g. february 20 (lowercase)
    - Can dynamically include this month's and/or last month's playlist at runtime 
* Last.fm track chart data
    - ONLY for "Last.fm Chart" type playlists
    - Include variable number of top tracks in the last date range

When not shuffled, playlists are date sorted with newest at the top for a rolling album artwork of newest releases.

Playlists are updated using the [spotframework](https://github.com/Sarsoo/spotframework) playlist engine three times a day.

# Tags

Groups of Last.fm objects for summing of scrobble counts and listening statistics.

![Tag Example](docs/TagExample.png)

## Structure

This repo consists of a front-end written in React.js and Material-UI being served by a back-end written in Flask.

The application is hosted on Google Cloud Infrastructure.

As this codebase stands it's not really re-useable as is, references to the cloud infrastructure are hard-coded.

## Acknowledgements

Took inspiration from Paul Lamere's [smarter playlists](http://smarterplaylists.playlistmachinery.com/).
changed music link to mixonomer 2022-08-07 19:33:16 +01:00			`[Mixonomer](https://mixonomer.sarsoo.xyz)`
add and delete playlists, spotify auth 2019-07-31 20:31:01 +01:00			`==================`

renaming music tools to mixonomer 2022-08-07 13:27:59 +01:00			`![Python Tests](https://github.com/sarsoo/Mixonomer/workflows/test%20and%20deploy/badge.svg)`
began testing, added CI 2021-02-07 18:32:07 +00:00
update README 2020-02-22 18:27:24 +00:00			`Set of utility tools for Spotify and Last.fm.`
renaming music tools to mixonomer 2022-08-07 13:27:59 +01:00			`Built on my other libraries for Spotify ([spotframework](https://github.com/Sarsoo/spotframework)), Last.fm ([fmframework](https://github.com/Sarsoo/pyfmframework)) and interfacing utility tools for the two ([spotfm](https://github.com/Sarsoo/pyfmframework)). Currently running on a suite of Google Cloud Platform services. An iOS client is currently under development [here](https://github.com/Sarsoo/Mixonomer-iOS).`
add and delete playlists, spotify auth 2019-07-31 20:31:01 +01:00
adding readme.md 2022-08-26 19:28:26 +01:00			`Read the full documentation [here](https://docs.mixonomer.sarsoo.xyz).`
adding docstrings, restructured reST 2021-03-24 10:06:54 +00:00
update README 2020-02-22 18:27:24 +00:00			`# Smart Playlists`

			`Create smart playlists for Spotify including tracks from playlists, library and Spotify recommendations.`

			`![Playlists List](docs/Playlists.png)`
			`![Playlist Example](docs/PlaylistExample.png)`

			`Playlists can pull tracks from multiple sources with some extra ones based on the playlist's type.`

			`* Spotify playlists`
			`- Currently referenced by case-sensitive names of those followed by the user`
			`- Plan to include reference by Spotify URI`
renaming music tools to mixonomer 2022-08-07 13:27:59 +01:00			`* Other Mixonomer playlists`
update README 2020-02-22 18:27:24 +00:00			`- Dynamically include the Spotify playlists of other managed playlists`
			`- Used to allow hierarchy playlists such as for genre (as seen above for multiple rap playlists)`
			`* Spotify Library Tracks`
			`* Monthly Playlists`
			`- ONLY for "Recents" type playlists`
			`- Find user playlists by name in the format "month year" e.g. february 20 (lowercase)`
			`- Can dynamically include this month's and/or last month's playlist at runtime`
			`* Last.fm track chart data`
			`- ONLY for "Last.fm Chart" type playlists`
			`- Include variable number of top tracks in the last date range`

			`When not shuffled, playlists are date sorted with newest at the top for a rolling album artwork of newest releases.`

			`Playlists are updated using the [spotframework](https://github.com/Sarsoo/spotframework) playlist engine three times a day.`

			`# Tags`

			`Groups of Last.fm objects for summing of scrobble counts and listening statistics.`

			`![Tag Example](docs/TagExample.png)`

			`## Structure`

			`This repo consists of a front-end written in React.js and Material-UI being served by a back-end written in Flask.`

			`The application is hosted on Google Cloud Infrastructure.`

			`As this codebase stands it's not really re-useable as is, references to the cloud infrastructure are hard-coded.`

			`## Acknowledgements`

			`Took inspiration from Paul Lamere's [smarter playlists](http://smarterplaylists.playlistmachinery.com/).`