TODO: Get `avconv` working. Oftentimes `play` won't be able to play some tracks due to an unsupported format; we'll need to use `avconv` to convert them (to WAV). (Done!) TODO: Get `play` working. (Done!) TODO: Get play-next working; probably just act like a shuffle. Will need to keep an eye out for the `play` process finishing. (Done!) TODO: Preemptively download and process the next track, while the current one is playing, to eliminate the silent time between tracks. (Done!) TODO: Delete old tracks! Since we aren't overwriting files, we need to manually delete files once we're done with them. (Done!) TODO: Get library filter path from stdin. (Done!) TODO: Show library tree. Do this AFTER filtering, so that people can e.g. see all albums by a specific artist. (Done!) TODO: Ignore .DS_Store. (Done!) TODO: Have a download timeout, somehow. TODO: Fix the actual group format. Often times we get single-letter files being downloaded (which don't exist); I'm guessing that's related to folder names (which are just strings, not title-href arrays) still being in the group array. (Update: that's defin- itely true; 'Saucey Sounds'[0] === 'S', and 'Unofficial'[0] === 'U', which are the two "files" it crashes on while playing -g 'Jake Chudnow'.) (Done!) TODO: A way to exclude a specific group path. (Done!) TODO: Better argv handling. (Done!) TODO: Option to include a specific path from the source playlist. (Done!) TODO: Make a playlist generator that parses http://billwurtz.com instrumentals.html. (Done!) TODO: Make crawl-itunes.js a bit more general, more command-line friendly (i.e. don't require editing the script itself), and make it use the getHTMLLinks function defined in the new crawl-links.js script. (Done!) TODO: Play-in-order track picker. (Done!) TODO: Volume controls. Who knows how to do this? It might have to be an argument passed to `play`. Being able to change the volume while it's playing would be nice, but I'm not sure if that's really possible. (Done! - To the greatest current ability.) TODO: Tempfiles, maybe? (Done!) TODO: Use NOT the internet as its source, so that it's a bit more general purpose. This would only take adding a new downloader. (Done!) TODO: Recursive local file playlist crawler. (Done!) TODO: *Requiring* a literal `playlist.json` file doesn't seem quite right, especially since there's the `--open` option. (Done!) TODO: Make local downlaoder sort more natural - that is, 10 comes immediately after 9, not 1. (1, 5, 9, 10, 12; not 1, 10, 12, 5, 9.) (Done!) TODO: Make a way to skip tracks while playing. Currently the only way is to kill and restart the http-music process; this is bad for numerous reasons, particularly because it gets rid of the pre-downloaded track and forces the user to wait for another one to be downloaded. (Done!) TODO: Make a --help/-h/-? option that directs helpless users to the man page. (Done!) TODO: Make a way to write the current playlist to a file. I think just renaming the debug-playlist-log option could work, since you could pipe that to a file through your shell. (Done!) TODO: Figure out a less "hacky" way to kill the process. Ideally we shouldn't have to handle ^C and ^D ourselves; for instance right now ^Z is actually broken, since we aren't using the shell's normal way of handling any keyboard controls such as those! TODO: Separate the code in loop-play.js to be a bit nicer. (Done!) TODO: Cleaning up http-music.js would be nice as well! TODO: A way to kill the up-next song. (Done!) TODO: A way to see information about the currently playing song, as well as the up-next song. (Done!) TODO: A way to see the previously played songs, and to skip back (or forwards). TODO: Exit on loop-play end. (Since it listens to stdin for input right now, it won't automatically stop.) TODO: Figure out how to attempt to avoid being forced to convert every file.. converting a 10MB MP3 into an 80MB WAV is never good, even if we're storing it as a tempfile! (Done!) TODO: Let playlist filter match things lowercase. '72 Minutes Of Fame' should be matched if '72 Minutes of Fame' can't be! (However, it would also be best to prioritize a case-sensitive match before a non-case-sensitive one. Given the input 'FoObAR', prioritize 'FoObAR' over 'Foobar'.) (Done!) TODO: Figure out why written track files (when using HTTP downloader) are URL-encoded. It's probably writing a file based on the href-file name, rather than the title. That's alright, but maybe we should URL-decode and then sanitize the href-file name, so that we get 'Foo Bar.mp3' instead of 'Foo%20Bar.mp3'. (Done!) TODO: Make max download attempts variable by the user (without requiring source editing, obviously). (Done!) TODO: Update HTTP crawl man page to include new options, and maybe update the HTTP crawler itself to reveal more options to the command line. TODO: Fix the bug in loop-play.js where wasDestroyed doesn't exist! (Done!) TODO: Use `mpv` instead of `play`!!!!!!!!! This would fix every problem ever. (Done!) TODO: It looks like up-next doesn't seem to work properly when using the YouTube downloader; though it's possible we'll be scrapping downloaders altogether.. (Done! - Removed downloaders.) TODO: The results of pressing key commands aren't very clear currently. Useful things that come to mind would be presenting the volume when it's changed; making it clear that a song is being skipped when it is; and having "paused" be part of the status bar. TODO: Figure out a way to make the same mpv process be reused, so that options such as volume can be remembered. (At the moment volume is reset to the default whenever a new track is played!) TODO: Figure out how to stream audio data directly, or at least at a lower level (and stupider, as in "man git" stupid). TODO: Validate local file paths in getDownloaderFor, maybe? TODO: Figure out the horrible, evil cause of the max listeners warning I'm getting lately.. current repro: play a bunch of files locally. Skipping tracks still leads to issue. Wait for them to start playing before skipping, though. (Done!) TODO: Something's requesting avprobe, and I'm not sure why. (While playing flora.json/YouTube videos.) Perhaps it's youtube-dl..? TODO: Re-implement skip. (Done!) TODO: Re-implement skip and view up-next track. (Done!) TODO: In the playlist downloader, we can't guarantee filenames - the OS likes to do its own verification, e.g. by removing colons. Maybe we can use sanitize file name? (Done!) TODO: In the playlist downloader, it would be nice if we skipped past existing files before trying to do any old files, so that the 'percent complete' status is more accurate. After all, we might skip 20% of the total track count because 20% were downloaded, and then we'd download one track, which makes up 10%, and then the rest would still be downloaded, which take up 70%. It would be better if we went from 0%, skipped ALL complete tracks to get to 90%, then did the 10% for the downloaded tracks. (Done!) TODO: Tracks should be able to contain more data than the title and downloader argument, by being stored as objects instead of arrays. This would also make it easier to implement things such as temporary state stored on tracks by sticking Symbols onto the track objects. It'd be particularly useful to store the original group path for tracks in flattenGroup, for example. (Done!) TODO: Piping the output of a crawl command into the http-music command would be nifty! (Done! - try '-o /dev/stdin'. This was apparently always a feature.) TODO: Having all the http-music commands be stuck into one main command might be nice, like the way git does it.. (Done!) TODO: Figure out how man pages work, and update the syntax in those files. Particularly I'd like to make the number of blank lines between headings more consistent, and figure out when to use '\-' or '-'. TODO: Fix skip up-next..! (Done!) TODO: Make iTunes crawler prefer album artist over artist. (Done!) TODO: Make iTunes crawler take into account track numbers. TODO: Make a YouTube playlist crawler. (Done!) TODO: The filter utility function shouldn't work at all if it fails to find what it's looking for. (Done!) TODO: Make the keep/remove options also work with tracks! TODO: The URL 'http://somesite.com/youtube.com.mp3' would probably automatically assume the YouTube downloader. Instead of checking for the string 'youtube.com' included in the downloader arg, check if it is a valid URL and that the URL's domain is 'youtube.com'. TODO: Figure out when to process.exit(1). In cli.js? TODO: Change usages of "/example/path" to a more specific "/path/to/playlist" (for example). (Done!) TODO: Support smart playlists right inside of play - and ideally any other usage, e.g. download-playlist. For now the user can just run smart-playlist, save the result, and load that in whatever command they're using. (`play` supported.) TODO: Markdown documentation? Man pages are nice, but aren't really all that user-friendly (citation needed); for example you can't easily read them online. (Whereas Markdown documents are easily viewed online, and aren't hard to read by hand, e.g. with `less doc/foo.md`.) TODO: Handle avconv failing (probably handle downloader rejections from within DownloadController). Less important now that only music file extensions are loaded, but still relevant (for old playlists which may contain .DS_Stores or album cover arts, etc). (Done!) TODO: Delete temporary files when done with them - seriously! http-music alone filled up a good 9GB of disk space, solely on temporary music files. (Done!) TODO: Players (MPV, SoX) should be separate (sub-)classes. (Done!) TODO: FIFO doesn't work on Windows. Implement a no-fifo player. (Done!) TODO: It looks like the SoX player is broken? - Fix this! (Done!) TODO: Support caps-lock variants of letter-based keyboard controls, and avoid separate functionality based on shift being pressed or not. (What this practically means is - make keyboard controls work even if caps-lock is pressed!) (Done!) TODO: Only create one converter instance (per DownloadController). (Done!) TODO: More selectors! No-loop/loop options of ordered and shuffled would be nice. (Done!) TODO: Magically watching for the play/pause keyboard button being pressed would be fun. (This would definitely be togglable via option!) TODO: Show the new up-next song when delete-up-next (backspace) is pressed. (Done!) TODO: safeUnlink probably shouldn't throw/reject if it fails to delete its given file (e.g. if a temporary file was automatically purged by the system before safeUnlink). Having a warning might be better? (Since *most* of the time it's probably a bug.) (Done!) TODO: A shuffle-groups picker would be fun! (That is, it would take a grouplike, then shuffle all the items on the TOP level; so it would play random (top-level) groups at a time.) (Done!) TODO: cheerio and xmldoc are both NPM dependencies. This seems Bad! TODO: Check if the `mkfifo` shell command exists when determining the player to use; if it doesn't, use mpv-nofifo. For better support on Windows! (Done!) TODO: History VOODOO! (Done!) TODO: Fix the shuffle players, which don't really work anymore (they more or less behave like pick-random). (Done!) TODO: Also fix the shuffle-groups player. (Done!) TODO: Consider adding pick-random back, in some way or another? TODO: The concepts of importing and adding keybindings isn't very intuitive.. TODO: A way to export the "timeline" playlist (though we'll need a better term) - that is, the flat result of the picker - would be awesome! TODO: I'm really, really bad at seeding randomness. Aaaaaa. Aaaaaaa. Aaa. AAAAAAA. (Fix the code. Unless it's working right already. Hmm.) (Done!) TODO: Now that we're using seeded randomness, generating the entire timeline every time we want to call the picker is definitely really slow. There should be some way to make it faster. (Maybe store the playlist on the mutable options object?). (Done!) TODO: Rename pickers2.js to pickers.js, and get rid of the old pickers.js. (Done!) TODO: Some way to control how verbose http-music is.. most people probably don't care about 'Indexing (flattening)', but it is handy for those on slow computers. TODO: Make the natural sort in crawl-local ignore capitalization case. (Done!) TODO: Make the '@ ...' part of track-info show the path to the track, rather than the track name again (this is a bug!). (Done!) TODO: Only show the path to a given track's group in the track info. (Done!) TODO: Figure out what to show in the '@ ...' part when a track is in the top level (i.e. its group is only the top). Probably just '/'? Probably best to make sure that the to-path-string function always returns a slash at the start. (Done!) TODO: Let track objects have an option for command line arguments to pass to the converter program (ffmpeg or avconv). This would be useful for a variety of cases: * Have a track which has two minutes of blank audio you want to skip? Make the converter skip past those first two minutes! * Have a track which is much quieter than the rest of your library? Make the converter amplify its volume! It'd also be useful with the 'apply' option of groups (e.g., amplify all the tracks in an album's group). Since there are differences between avconv and ffmepg, it'd be recommended to specify the converter program via the "options" part of the playlist. When http-music finds that a playlist has asked for a converter program that isn't installed, it simply won't run the convertion options on the tracks in the playlist. (Done!) TODO: Should the '@ ...' part display the path to the track in the SOURCE playlist, rather than in the active one? I'm split on this; showing the active path is handy for debugging or writing your own playlist, but showing the source path is usually more practically useful, so you know where the album came from (e.g. displaying /C418/BAM instead of /BAM). TODO: Let playlists be passed to `play` by an actual string argument; e.g. --playlist-string '{"tracks": [...]}'. Could work well with http-music's own crawler utilities (e.g. --playlist-string '{"source": ["crawl-local", "."]}' or with external ones (e.g. --playlist-string "$(cool-crawler-utilith.sh)". At the moment the only workaround is to use a temporary file to store the playlist in, or to pipe the output of the crawler command (which might be `echo`!) to http- music and use /dev/stdin as the --playlist-file value.. which obviously isn't cross-platform or practical! (Done!) TODO: A way to search the playlist for a path. Probably best to modify the function which filters a grouplike by a path. I think I'll hide this feature behind a special prefix, e.g. -c -k '?72 Minutes of Fame'. (Done!) TODO: Case-insensitive checking with command keybindings - I think this is broken with the new command system. (Done!) TODO: Handle empty (active) playlists. Showing an error message and stopping is best, I think. (Done!) TODO: A way to switch between what information is displayed in the status bar. I think using ">" and "<" as default keybindings would work. Make one set be (track # in group) / (# of tracks in group); one be (total track #) / (total # of tracks). TODO: Adding onto the last one, show the total amount of time in the group/all groups together. Requires a track metadata tool, though... TODO: Make process-metadata work with non-local tracks, somehow... TODO: Make process-metadata work nicely with smart playlists, somehow... TODO: A way (key, option) to change the "/ duration" text in the status bar to "- remaining". This would work very nicely with the >/< status bar idea. TODO: Be a bit more loose (strict?) about what means crashing... Right now if five tracks fail to play in a row, http-music stops. This is good for dealing with, for example, a messed up playlist file that now references moved MP3s, since "failing" means "the download failed". But if the PLAY command fails (i.e. mpv or sox exits with code 1), THAT should also be counted as a failure. (An example case of the "play" command failing -- trying to play a track when there is no audio device.) (Done!) TODO: Group/album length visualizer thing!!! Colorful and PRETTY. Only work on the first level of groups since I'm lazy and don't want to figure out how to nicely display multiple levels. Use --keep + --save to use the viz on specific albums (or maybe implement --clear, --keep, etc as common code between the player and the visualizer, shrug). Also using --collapse would work for comparing album lengths rather than artist lengths. (Done!) TODO: Show mean/media/mode statistics for songs in duration-graph. TODO: In duration-graph, show warning message if *no* items in a playlist have duration metadata (direct the user to use process-metadata).