]> git.r.bdr.sh - rbdr/lyricli.rb/blame_incremental - doc/index.html
Updates the readme.
[rbdr/lyricli.rb] / doc / index.html
... / ...
CommitLineData
1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
4 <head>
5 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
6<title>
7 File: README
8
9 &mdash; Documentation by YARD 0.8.2.1
10
11</title>
12
13 <link rel="stylesheet" href="css/style.css" type="text/css" media="screen" charset="utf-8" />
14
15 <link rel="stylesheet" href="css/common.css" type="text/css" media="screen" charset="utf-8" />
16
17<script type="text/javascript" charset="utf-8">
18 hasFrames = window.top.frames.main ? true : false;
19 relpath = '';
20 framesUrl = "frames.html#!" + escape(window.location.href);
21</script>
22
23
24 <script type="text/javascript" charset="utf-8" src="js/jquery.js"></script>
25
26 <script type="text/javascript" charset="utf-8" src="js/app.js"></script>
27
28
29 </head>
30 <body>
31 <div id="header">
32 <div id="menu">
33
34 <a href="_index.html">Index</a> &raquo;
35 <span class="title">File: README</span>
36
37
38 <div class="noframes"><span class="title">(</span><a href="." target="_top">no frames</a><span class="title">)</span></div>
39</div>
40
41 <div id="search">
42
43 <a class="full_list_link" id="class_list_link"
44 href="class_list.html">
45 Class List
46 </a>
47
48 <a class="full_list_link" id="method_list_link"
49 href="method_list.html">
50 Method List
51 </a>
52
53 <a class="full_list_link" id="file_list_link"
54 href="file_list.html">
55 File List
56 </a>
57
58</div>
59 <div class="clear"></div>
60 </div>
61
62 <iframe id="search_frame"></iframe>
63
64 <div id="content"><div id='filecontents'><h1>Lyricli</h1>
65
66<h2>The command line client for lyrics</h2>
67
68<p>This is a quick introduction for Lyricli. Right now it&#39;s in really early
69stages of development, so it&#39;s lacking in a lot of stuff (mainly tests
70and documentation) ... But it generally works and here&#39;s a tutorial to
71see how to get it working.</p>
72
73<h3>Installing</h3>
74
75<ol>
76<li>Clone this Repo</li>
77<li><code>gem build lyricli.gemspec</code></li>
78<li><code>gem install lyricli-0.0.1.gem</code></li>
79<li>Voila!</li>
80</ol>
81
82<h3>Usage</h3>
83
84<p>Lyricli can be invoked with the command <code>lrc</code> and there are three basic
85ways of using it:</p>
86
87<p><code>lrc</code></p>
88
89<p>When you run it without arguments, it will look in the available sources
90to try to find a playing song and extract the lyrics.</p>
91
92<p><code>lrc artist song</code></p>
93
94<p>When you run it with arguments, it will use them to search for the
95lyrics. This won&#39;t work if you manually disable the arguments source in
96your configuration file.</p>
97
98<h4>Commands</h4>
99
100<p>The third way to use it is by passing it one of the following special
101commands:</p>
102
103<ul>
104<li><code>lrc -l</code> or <code>lrc --list-sources</code> lists the available sources.</li>
105<li><code>lrc -e</code> or <code>lrc --enable SOURCE</code> enable a source from the list.</li>
106<li><code>lrc -d</code> or <code>lrc --disable SOURCE</code> disable a source from the list.</li>
107<li><code>lrc -r</code> or <code>lrc --reset SOURCE</code> reset all configuration for a source.</li>
108<li><code>lrc -v</code> or <code>lrc --version</code> show the installed version of lyricli.</li>
109<li><code>lrc -h</code> or <code>lrc --help</code> display some help</li>
110</ul>
111
112<h3>Roadmap</h3>
113
114<p>There is not much defined right now as a roadmap, but this needs to be
115done:</p>
116
117<ul>
118<li>Specs for all the components</li>
119<li>YARD documentation for all the components</li>
120</ul>
121
122<p>And the first thing I want to work on after that is done is separating
123the Lyrics Engines so we can add/remove lyrics engines in a similar way to how
124we currently add/remove sources.</p>
125
126<h3>Leave Feedback Please!</h3>
127
128<p>If you decide to use or hack away at Lyricly, please don&#39;t forget to
129post any issues you find.</p>
130
131<h3>License</h3>
132
133<p>Licensed under 3-clause-BSD.</p>
134</div></div>
135
136 <div id="footer">
137 Generated on Sat Oct 6 03:20:24 2012 by
138 <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
139 0.8.2.1 (ruby-1.9.2).
140</div>
141
142 </body>
143</html>