Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cvzi/itunes_smartplaylist
iTunes Smart playlist parser with Python. Convert to Kodi xsp smart playlists.
https://github.com/cvzi/itunes_smartplaylist
base64 itunes itunes-library itunes-playlist itunes-smart-playlists kodi kodie-smart-playlists parser playlist xbmc xspark
Last synced: 28 days ago
JSON representation
iTunes Smart playlist parser with Python. Convert to Kodi xsp smart playlists.
- Host: GitHub
- URL: https://github.com/cvzi/itunes_smartplaylist
- Owner: cvzi
- License: mit
- Created: 2015-04-12T10:54:41.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2023-03-08T08:31:38.000Z (over 1 year ago)
- Last Synced: 2024-10-04T22:51:11.612Z (about 1 month ago)
- Topics: base64, itunes, itunes-library, itunes-playlist, itunes-smart-playlists, kodi, kodie-smart-playlists, parser, playlist, xbmc, xspark
- Language: Python
- Homepage:
- Size: 204 KB
- Stars: 16
- Watchers: 3
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
iTunes Smartplaylist parser
===========================
[](https://pypi.org/project/itunessmart/)
[](https://pypi.python.org/pypi/itunessmart)
[](https://coveralls.io/github/cvzi/itunes_smartplaylist?branch=master)
[](https://www.codacy.com/app/cvzi/itunes_smartplaylist?utm_source=github.com&utm_medium=referral&utm_content=cvzi/itunes_smartplaylist&utm_campaign=Badge_Grade)
[](https://travis-ci.org/cvzi/itunes_smartplaylist)
Convert smart playlist information to a readable form.
This module is a **Python 3** implementation, based on [banshee-itunes-import-plugin](https://code.google.com/archive/p/banshee-itunes-import-plugin/) by [Scott Peterson](https://github.com/lunchtimemama).
It was tested on Windows 10 with iTunes 12.10.6.2 (64bit) and Python 3.8.
It does not work with Python 2.x.
Kodi smart playlists
--------------------
You can convert all your iTunes smart playlists to Kodi smart playlists with this interactive script:
`python3 utils/export_xsp.py` or `python3 -m itunessmart`
Then place the resulting .xsp files from `out/` in your [userdata](http://kodi.wiki/view/Userdata) folder.
Most of the common functions and rules are available in both formats and often iTunes playlists are fully convertible to Kodi.
The biggest difference are nested rules in iTunes which are not available in Kodi.
However, nested rules can be simulated with sub-playlists. These "helper"-playlists are named with the prefix "zzzsub_" and a MD5 hash of its rules.
When you run `utils/export_xsp.py`, you can disable generation of subplaylists.
More information on Kodie smart playlists:
[http://kodi.wiki/view/smart_playlists#Format_of_a_smart_playlist_file](http://kodi.wiki/view/smart_playlists#Format_of_a_smart_playlist_file)
Text export
-----------
To export all playlists to text files, use `python3 utils/export.py`
The format
----------
Smart playlist data in iTunes is saved in the *iTunes Music Library.xml* file.
The data in the playlist entry in the xml file is base64 encoded binary data:
```xml
NameExample
Playlist ID123456
Playlist Persistent ID49C97D85843B04CC
Parent Persistent ID4DA0F774D3F70473
All Items
Smart Info
AQEAAwAAAAIAAAAZAAAAAAAAAAcAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAA==
Smart Criteria
U0xzdAABAAEAAAADAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABYAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABEAAAAAAAAAA8AAAAAAAAAAAAAAAAAAAABAAAA
AAAAAA8AAAAAAAAAAAAAAAAAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQEAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAB/FNMc3QAAQABAAAAAw
AAAAEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAWAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAARAAAAAAAAAAQAAAAAAAAAAAAAAAAAAAAAQAAAAAAAAAQAAAAAAAAAA
AAAAAAAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAFgAAABAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEQAAAAAAAAAEQAAAAAAAAAAAAAAAAAAAAEA
AAAAAAAAEQAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABYAAAAQAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABEAAAAAAAAABIAAA
AAAAAAAAAAAAAAAAABAAAAAAAAABIAAAAAAAAAAAAAAAAAAAABAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAZAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAARAAAAAAAAABZAAAAAAAAAAAAAAAAAAAAAQAAAAAAAABZAAAAAAAAAAAAAAAAAAAAAQAAA
AAAAAAAAAAAAAAAAAAAAAAA
Playlist Items
Track ID123
Track ID124
...
```
It can be converted into three different output formats:
```python
import itunessmart
info = "AQEAAwAAAAIAAAAZ..."
criteria = "U0xzdAABAAEAAAAD..."
parser = itunessmart.Parser(info, criteria)
result = parser.result
print(result.output)
print(result.query)
print(json.dumps(result.queryTree, indent=2))
```
A text format:
```python
Plays is greater than 15 and
[
Plays is greater than 16 or
Plays is greater than 17 or
Plays is greater than 18
] and
Rating is greater than 4
```
A sql-like format:
```sql
(Plays > 15) AND ( (Plays > 16) OR (Plays > 17) OR (Plays > 18) ) AND (Rating > 4)
```
And two tree structures
```javascript
{
"tree": {
"and": [
[
"Plays",
"(Plays > 15)"
],
{
"or": [
[
"Plays",
"(Plays > 16)"
],
[
"Plays",
"(Plays > 17)"
],
[
"Plays",
"(Plays > 18)"
]
]
},
[
"Rating",
"(Rating > 4)"
]
]
},
"liveupdate": true,
"onlychecked": false
}
```
```javascript
{
"fulltree": {
"and": [
{
"field": "Plays",
"type": "int",
"operator": "greater than",
"value": 15
},
{
"or": [
{
"field": "Plays",
"type": "int",
"operator": "greater than",
"value": 16
},
{
"field": "Plays",
"type": "int",
"operator": "greater than",
"value": 17
},
{
"field": "Plays",
"type": "int",
"operator": "greater than",
"value": 18
}
]
},
{
"field": "Rating",
"type": "int",
"operator": "greater than",
"value": 4
}
]
}
}
```