diff --git a/README.md b/README.md index 01a25e4..2ac7dc7 100644 --- a/README.md +++ b/README.md @@ -32,7 +32,8 @@ $ pip install . # for others | -t | --title | Playlist title | Title string | | -g | --encoding | Text encoding | UTF-8,ASCII,UNICODE | | -I | --image | Playlist image | Image path | -| -l | --link | Add local or remote files | Files | +| -l | --link | Add remote file links | Http links | +| -F | --file | Add files | Files | | -j | --join | Join one or more other playlist files | Playlist files | | -n | --cache | Cache playlist results | Seconds | | -U | --url-chars | Substitute some chars with URL Encoding | | @@ -61,81 +62,88 @@ $ pip install . # for others cd myalbum mkpl myalbum.m3u ``` + +2. Create a playlist for one music album and add other multimedia files (`-F` option): + + ```bash + cd myalbum_special + mkpl myalbum_special.m3u -F music_video.mp4 other_stuff/song1.mp3 other_stuff/song2.mp3 + ``` -2. Create a playlist of a film saga +3. Create a playlist of a film saga ```bash mkpl -d HarryPotter -f mkv HP_saga.m3u ``` -3. Create a shuffled playlist with my music collection; include only files with minimum size of 2 Megabyte +4. Create a shuffled playlist with my music collection; include only files with minimum size of 2 Megabyte ```bash mkpl -d "my_mp3_collection" "my_mp4_collection" -rs -z 2mb "my music.m3u" ``` -4. Create a shuffled playlist with my music collection and exclude dirs +5. Create a shuffled playlist with my music collection and exclude dirs ```bash mkpl -d "my_mp3_collection" "my_mp4_collection" -r -s -e "my_mp3_collection/metallica" "my_mp3_collection/dk" -- "my music.m3u" ``` -5. Create a TV series playlist with max 15 tracks +6. Create a TV series playlist with max 15 tracks ```bash mkpl -d "my_series/GOT" -m 15 "got_first_15.m3u" ``` -6. Add into _my music_ playlist new songs and don't add same file +7. Add into _my music_ playlist new songs and don't add same file ```bash mkpl -d "new_collection" -rsu "my music.m3u" -a ``` -7. Create playlist with music and video files if files is greater then 10MB +8. Create playlist with music and video files if files is greater then 10MB ```bash mkpl -d "my_files" -r -z 10485760 "multimedia.m3u" ``` -8. Create playlist with only number one and two tracks with regular expression +9. Create playlist with only number one and two tracks with regular expression ```bash mkpl -d "my_mp3_collection" -r -p "^[12]|[012]{2}" "my music.m3u" ``` -9. Create a playlist for one music album and set the title: +10. Create a playlist for one music album and set the title: - ```bash - cd myalbum - mkpl myalbum.m3u -t "My Album" - ``` + ```bash + cd myalbum + mkpl myalbum.m3u -t "My Album" + ``` -10. Create a playlist and add _UTF-8_ encoding +11. Create a playlist and add _UTF-8_ encoding ```bash mkpl -d "new_collection" -r "my music.m3u" -g "UTF-8" ``` -11. Create a playlist and set image +12. Create a playlist and set image ```bash mkpl -d "new_collection" -r "my music.m3u" -I "new_collection/playlist_cover.jpg" ``` -12. Create a playlist and add remote file links +13. Create a playlist and add remote file links ```bash mkpl -d "new_collection" -r "my music.m3u" -l http://192.168.1.123/mp3/song1.mp3, http://192.168.1.123/mp3/song2.mp4 ``` -13. Create a playlist and set Windows backslash (\\) folder separator (for Windows OS) +14. Create a playlist and set Windows backslash (\\) folder separator (for Windows OS) ```bash mkpl -d "new_collection" -r "my music.m3u" -w ``` -14. Split playlist into _N_ playlists fon _N_ directories +15. Split playlist into _N_ playlists fon _N_ directories ```bash mkpl -d "folder1" "folder2" "folder3" -r "my_music.m3u" -S @@ -150,7 +158,7 @@ $ pip install . # for others ... ``` -15. Sort playlist files by name (`-o`), by creation date (`-O`), by track number (`-T`), by year (`-y`), by size (`-Z`) or by length (`-L`): +16. Sort playlist files by name (`-o`), by creation date (`-O`), by track number (`-T`), by year (`-y`), by size (`-Z`) or by length (`-L`): ```bash mkpl -d "new_collection" -r "my music.m3u" -o @@ -161,20 +169,20 @@ $ pip install . # for others mkpl -d "new_collection" -r "my music.m3u" -L ``` -16. Join the _"First playlist.m3u"_ and _"Second playlist.m3u8"_ with new **"Third playlist.m3u"**: +17. Join the _"First playlist.m3u"_ and _"Second playlist.m3u8"_ with new **"Third playlist.m3u"**: ```bash mkpl -d "new_collection" -r "Third playlist" -j "First playlist.m3u" "Second playlist.m3u8" ``` -17. Counts the multimedia files: +18. Counts the multimedia files: ```console mkpl -d "new_collection" -r "My new collection" -C 4023 ``` -18. Asks confirmation for every file into folders: +19. Asks confirmation for every file into folders: ```console mkpl -d "new_collection" -r "My new collection" -R