'\" t
.\"     Title: zomg
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\"      Date: 11/17/2009
.\"    Manual: User commands
.\"    Source: User commands
.\"  Language: English
.\"
.TH "ZOMG" "1" "11/17/2009" "User commands" "User commands"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
zomg \- last\&.fm submission and radio client
.SH "SYNOPSIS"
.HP \w'\fBzomg\fR\ 'u
\fBzomg\fR [\fB\-n\fR] [\fB\-t\fR] [\fB\-z\fR] [musicfile...]
.HP \w'\fBzomg\fR\ 'u
\fBzomg\fR \fB\-r\fR [lastm\ url]
.SH "DESCRIPTION"
.PP
For each file given on the command line,
\fBzomg\fR
will attempt to play the track then submit the requisite metadata to your last\&.fm profile, libre\&.fm profile, or any combination of servers you have configured in ~/\&.zomg/conf \&.
.PP
If it fails to get a success response or if
\fB\-n\fR
is used,
\fBzomg\fR
will stop attempting to make outbound TCP connections, and will cache played tracks until
\fBzomg\fR
is next invoked, at which point it will attempt to flush the cache (thereby submitting all tracks to the servers)\&. Independent caches are maintained per\-service\&.
.PP
To pass directories instead of files, use the
\fB\-t\fR
option\&.
\fBzomg\fR
will recurse through each directory given on the command line and add playables file within to its internal playlist\&.
.PP
If
\fB\-z\fR
is used,
\fBzomg\fR
will shuffle the order that the tracks in the internal playlist (either passed on the command line without
\fB\-t\fR
or within directories passed on the command line with
\fB\-t\fR) are played\&.
.PP
Finally, if
\fB\-r\fR
is used,
\fBzomg\fR
will enter interactive radio mode\&. If a last\&.fm URL is passed to
\fBzomg\fR
\fB\-r\fR, it will tune to that station before presenting the user with its initial prompt\&.