Msync Seemingly Stable
I’ve approached a point with msync where it seems to be stable enough (i.e. I can’t think of where else to go with/what else to add to the base library). I’m going to start working to test everything for everyday use by starting a library with my music collection and using it to manage my Sansa files. I’ll be sure to post again once I’ve decided to start working on the GUI frontend for it. In the meantime, I’ve attached the help information for anyone interested in seeing what it can do.
> msync help
usage: msync <subcommand> [options] [args]
msync command line client
Type ‘msync help <subcommand>’ for help for a specific subcommand
Available subcommands:
library (lib)
playlist (pl)
synclist (sl)
> msync help library
library (lib): modify or read the library.
usage: library <subcommand> [args]
Available subcommands:
add
check
delete (del, remove, rm)
list (ls)
paths
playlists (pls)
rescan (rs)
update (up)
> msync help library add
add: add a file or directory (recursively) to the library.
usage: add <file|directory>
> msync help library check
check: checks the sanity of the library compared to the files on disk.
usage: check [directory]
Notifies the user of any files in the library that it can no longer access.
> msync help library delete
delete: delete a file or directory (recursively) from the library.
usage: delete [file|directory]
WARNING: running this command without arguments will erase the contents of the
library from the database.
> msync help library list
list: list the files in the library.
usage: list [--artist|--album|--title|--genre|--year|--filename] [arg]
Files with attributes matching the option and argument passed will be
shown. For example, if run as ‘list –genre “Punk”‘, it will show all tracks
in the library with the genre Punk. If no options are passed, it will list
all files in the library.
Wildcards are permitted, but the argument must then be enclosed in quotes
so the shell does not try to expand the wildcard character (*).
> msync help library paths
paths: list the base paths in the library.
usage: paths
> msync help library playlists
playlists: show all playlists bound to this library.
usage: playlists
> msync help library rescan
rescan: scans and adds or updates all files whether or not they’ve been updated
on the filesystem.
usage: rescan [file|directory]
Running this command without arguments will rescan all directories and files.
> msync help library update
update: rescan the library for new files or modifications of existing files.
usage: update [file|directory]
Running this command without arguments will rescan all directories and files.
> msync help playlist
playlist (pl): modify or read the playlist.
usage: playlist <name> <subcommand> [options] [args]
Available subcommands:
add
copy (cp)
create (new)
delete (del, remove, rm)
export (ex)
info
list (ls)
move (mv, rename, ren)
position (pos)
sync
> msync help playlist add
add: add a file or directory (recursively) to the playlist.
usage: add [--artist|--album|--title|--genre|--year|--filename] <arg>
The file will be added depending on the option passed. For example, if run as
‘add –artist “Converge”‘, it will add all tracks in the library by Converge.
If no option is passed, it defaults to filename.
> msync help playlist copy
copy: copies the contents of one playlist into another.
usage: copy <playlist2>
If the second playlist does not exist, it will be created.
> msync help playlist create
create: creates an empty playlist.
usage: create
> msync help playlist delete
delete: delete a file or directory (recursively) from the playlist.
usage: delete [--artist|--album|--title|--genre|--year|--position|--filename] [arg]
The files will be deleted depending on the option passed. For example, if run as
‘delete –album “Termites In His Smile”‘, it will delete all tracks in the library
on the album Termites In His Smile. If no option is passed, it defaults to filename.
If called with no options or arguments, it will remove this playlist from the database.
> msync help playlist export
export: write a playlist to the filesystem in the form of an m3u file.
usage: export <directory>
> msync help playlist info
info: prints the length and size of the playlist.
usage: info
> msync help playlist list
list: prints the files contained in the playlist.
usage: list
> msync help playlist move
move: moves the playlist from one name to another.
usage: move <new playlist>
The operation will not continue if the second playlist already exists.
> msync help playlist position
position: changes position of a file in the playlist.
usage: position <old> <new>
> msync help playlist sync
sync: synchronizes a playlist to a remote directory.
usage: sync [--remove|-r] <directory> [[--size|-s SIZE]|[--format|-f FORMAT]]
> msync help synclist
synclist (sl): modify, read, or synchronize a playlist tracker.
usage: synclist <subcommand> [args]
Available subcommands:
list (ls)
mark
sync
unmark
> msync help synclist list
list: prints the playlists currently set to sync.
usage: list [all]
If passed with the ‘all’ argument, it will print all playlists currently available,
with an (X) next to the ones that are currently selected to sync.
> msync help synclist mark
mark: sets a playlist’s status to sync.
usage: mark <playlist name>
> msync help synclist sync
sync: syncs all currently selected playlists to a remote directory.
usage: sync <directory> [[--size|-s SIZE]|[--format|-f FORMAT]]
> msync help synclist unmark
unmark: sets a playlist’s status to not sync.
usage: unmark <playlist name>