1
=== added file 'LICENSE'
2
--- LICENSE	1970-01-01 00:00:00 +0000
3
+++ LICENSE	2009-03-09 20:55:34 +0000
4
@@ -0,0 +1,225 @@
5
1
GNU GENERAL PUBLIC LICENSE
6
2
7
3
Version 3, 29 June 2007
8
4
9
5
Copyright © 2007 Free Software Foundation, Inc. <http://fsf.org/>
10
6
11
7
Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
12
8
Preamble
13
9
14
10
The GNU General Public License is a free, copyleft license for software and other kinds of works.
15
11
16
12
The licenses for most software and other practical works are designed to take away your freedom to share and change the works. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change all versions of a program--to make sure it remains free software for all its users. We, the Free Software Foundation, use the GNU General Public License for most of our software; it applies also to any other work released this way by its authors. You can apply it to your programs, too.
17
13
18
14
When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for them if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs, and that you know you can do these things.
19
15
20
16
To protect your rights, we need to prevent others from denying you these rights or asking you to surrender the rights. Therefore, you have certain responsibilities if you distribute copies of the software, or if you modify it: responsibilities to respect the freedom of others.
21
17
22
18
For example, if you distribute copies of such a program, whether gratis or for a fee, you must pass on to the recipients the same freedoms that you received. You must make sure that they, too, receive or can get the source code. And you must show them these terms so they know their rights.
23
19
24
20
Developers that use the GNU GPL protect your rights with two steps: (1) assert copyright on the software, and (2) offer you this License giving you legal permission to copy, distribute and/or modify it.
25
21
26
22
For the developers' and authors' protection, the GPL clearly explains that there is no warranty for this free software. For both users' and authors' sake, the GPL requires that modified versions be marked as changed, so that their problems will not be attributed erroneously to authors of previous versions.
27
23
28
24
Some devices are designed to deny users access to install or run modified versions of the software inside them, although the manufacturer can do so. This is fundamentally incompatible with the aim of protecting users' freedom to change the software. The systematic pattern of such abuse occurs in the area of products for individuals to use, which is precisely where it is most unacceptable. Therefore, we have designed this version of the GPL to prohibit the practice for those products. If such problems arise substantially in other domains, we stand ready to extend this provision to those domains in future versions of the GPL, as needed to protect the freedom of users.
29
25
30
26
Finally, every program is threatened constantly by software patents. States should not allow patents to restrict development and use of software on general-purpose computers, but in those that do, we wish to avoid the special danger that patents applied to a free program could make it effectively proprietary. To prevent this, the GPL assures that patents cannot be used to render the program non-free.
31
27
32
28
The precise terms and conditions for copying, distribution and modification follow.
33
29
TERMS AND CONDITIONS
34
30
0. Definitions.
35
31
36
32
“This License” refers to version 3 of the GNU General Public License.
37
33
38
34
“Copyright” also means copyright-like laws that apply to other kinds of works, such as semiconductor masks.
39
35
40
36
“The Program” refers to any copyrightable work licensed under this License. Each licensee is addressed as “you”. “Licensees” and “recipients” may be individuals or organizations.
41
37
42
38
To “modify” a work means to copy from or adapt all or part of the work in a fashion requiring copyright permission, other than the making of an exact copy. The resulting work is called a “modified version” of the earlier work or a work “based on” the earlier work.
43
39
44
40
A “covered work” means either the unmodified Program or a work based on the Program.
45
41
46
42
To “propagate” a work means to do anything with it that, without permission, would make you directly or secondarily liable for infringement under applicable copyright law, except executing it on a computer or modifying a private copy. Propagation includes copying, distribution (with or without modification), making available to the public, and in some countries other activities as well.
47
43
48
44
To “convey” a work means any kind of propagation that enables other parties to make or receive copies. Mere interaction with a user through a computer network, with no transfer of a copy, is not conveying.
49
45
50
46
An interactive user interface displays “Appropriate Legal Notices” to the extent that it includes a convenient and prominently visible feature that (1) displays an appropriate copyright notice, and (2) tells the user that there is no warranty for the work (except to the extent that warranties are provided), that licensees may convey the work under this License, and how to view a copy of this License. If the interface presents a list of user commands or options, such as a menu, a prominent item in the list meets this criterion.
51
47
1. Source Code.
52
48
53
49
The “source code” for a work means the preferred form of the work for making modifications to it. “Object code” means any non-source form of a work.
54
50
55
51
A “Standard Interface” means an interface that either is an official standard defined by a recognized standards body, or, in the case of interfaces specified for a particular programming language, one that is widely used among developers working in that language.
56
52
57
53
The “System Libraries” of an executable work include anything, other than the work as a whole, that (a) is included in the normal form of packaging a Major Component, but which is not part of that Major Component, and (b) serves only to enable use of the work with that Major Component, or to implement a Standard Interface for which an implementation is available to the public in source code form. A “Major Component”, in this context, means a major essential component (kernel, window system, and so on) of the specific operating system (if any) on which the executable work runs, or a compiler used to produce the work, or an object code interpreter used to run it.
58
54
59
55
The “Corresponding Source” for a work in object code form means all the source code needed to generate, install, and (for an executable work) run the object code and to modify the work, including scripts to control those activities. However, it does not include the work's System Libraries, or general-purpose tools or generally available free programs which are used unmodified in performing those activities but which are not part of the work. For example, Corresponding Source includes interface definition files associated with source files for the work, and the source code for shared libraries and dynamically linked subprograms that the work is specifically designed to require, such as by intimate data communication or control flow between those subprograms and other parts of the work.
60
56
61
57
The Corresponding Source need not include anything that users can regenerate automatically from other parts of the Corresponding Source.
62
58
63
59
The Corresponding Source for a work in source code form is that same work.
64
60
2. Basic Permissions.
65
61
66
62
All rights granted under this License are granted for the term of copyright on the Program, and are irrevocable provided the stated conditions are met. This License explicitly affirms your unlimited permission to run the unmodified Program. The output from running a covered work is covered by this License only if the output, given its content, constitutes a covered work. This License acknowledges your rights of fair use or other equivalent, as provided by copyright law.
67
63
68
64
You may make, run and propagate covered works that you do not convey, without conditions so long as your license otherwise remains in force. You may convey covered works to others for the sole purpose of having them make modifications exclusively for you, or provide you with facilities for running those works, provided that you comply with the terms of this License in conveying all material for which you do not control copyright. Those thus making or running the covered works for you must do so exclusively on your behalf, under your direction and control, on terms that prohibit them from making any copies of your copyrighted material outside their relationship with you.
69
65
70
66
Conveying under any other circumstances is permitted solely under the conditions stated below. Sublicensing is not allowed; section 10 makes it unnecessary.
71
67
3. Protecting Users' Legal Rights From Anti-Circumvention Law.
72
68
73
69
No covered work shall be deemed part of an effective technological measure under any applicable law fulfilling obligations under article 11 of the WIPO copyright treaty adopted on 20 December 1996, or similar laws prohibiting or restricting circumvention of such measures.
74
70
75
71
When you convey a covered work, you waive any legal power to forbid circumvention of technological measures to the extent such circumvention is effected by exercising rights under this License with respect to the covered work, and you disclaim any intention to limit operation or modification of the work as a means of enforcing, against the work's users, your or third parties' legal rights to forbid circumvention of technological measures.
76
72
4. Conveying Verbatim Copies.
77
73
78
74
You may convey verbatim copies of the Program's source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice; keep intact all notices stating that this License and any non-permissive terms added in accord with section 7 apply to the code; keep intact all notices of the absence of any warranty; and give all recipients a copy of this License along with the Program.
79
75
80
76
You may charge any price or no price for each copy that you convey, and you may offer support or warranty protection for a fee.
81
77
5. Conveying Modified Source Versions.
82
78
83
79
You may convey a work based on the Program, or the modifications to produce it from the Program, in the form of source code under the terms of section 4, provided that you also meet all of these conditions:
84
80
85
81
    * a) The work must carry prominent notices stating that you modified it, and giving a relevant date.
86
82
    * b) The work must carry prominent notices stating that it is released under this License and any conditions added under section 7. This requirement modifies the requirement in section 4 to “keep intact all notices”.
87
83
    * c) You must license the entire work, as a whole, under this License to anyone who comes into possession of a copy. This License will therefore apply, along with any applicable section 7 additional terms, to the whole of the work, and all its parts, regardless of how they are packaged. This License gives no permission to license the work in any other way, but it does not invalidate such permission if you have separately received it.
88
84
    * d) If the work has interactive user interfaces, each must display Appropriate Legal Notices; however, if the Program has interactive interfaces that do not display Appropriate Legal Notices, your work need not make them do so.
89
85
90
86
A compilation of a covered work with other separate and independent works, which are not by their nature extensions of the covered work, and which are not combined with it such as to form a larger program, in or on a volume of a storage or distribution medium, is called an “aggregate” if the compilation and its resulting copyright are not used to limit the access or legal rights of the compilation's users beyond what the individual works permit. Inclusion of a covered work in an aggregate does not cause this License to apply to the other parts of the aggregate.
91
87
6. Conveying Non-Source Forms.
92
88
93
89
You may convey a covered work in object code form under the terms of sections 4 and 5, provided that you also convey the machine-readable Corresponding Source under the terms of this License, in one of these ways:
94
90
95
91
    * a) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), accompanied by the Corresponding Source fixed on a durable physical medium customarily used for software interchange.
96
92
    * b) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), accompanied by a written offer, valid for at least three years and valid for as long as you offer spare parts or customer support for that product model, to give anyone who possesses the object code either (1) a copy of the Corresponding Source for all the software in the product that is covered by this License, on a durable physical medium customarily used for software interchange, for a price no more than your reasonable cost of physically performing this conveying of source, or (2) access to copy the Corresponding Source from a network server at no charge.
97
93
    * c) Convey individual copies of the object code with a copy of the written offer to provide the Corresponding Source. This alternative is allowed only occasionally and noncommercially, and only if you received the object code with such an offer, in accord with subsection 6b.
98
94
    * d) Convey the object code by offering access from a designated place (gratis or for a charge), and offer equivalent access to the Corresponding Source in the same way through the same place at no further charge. You need not require recipients to copy the Corresponding Source along with the object code. If the place to copy the object code is a network server, the Corresponding Source may be on a different server (operated by you or a third party) that supports equivalent copying facilities, provided you maintain clear directions next to the object code saying where to find the Corresponding Source. Regardless of what server hosts the Corresponding Source, you remain obligated to ensure that it is available for as long as needed to satisfy these requirements.
99
95
    * e) Convey the object code using peer-to-peer transmission, provided you inform other peers where the object code and Corresponding Source of the work are being offered to the general public at no charge under subsection 6d.
100
96
101
97
A separable portion of the object code, whose source code is excluded from the Corresponding Source as a System Library, need not be included in conveying the object code work.
102
98
103
99
A “User Product” is either (1) a “consumer product”, which means any tangible personal property which is normally used for personal, family, or household purposes, or (2) anything designed or sold for incorporation into a dwelling. In determining whether a product is a consumer product, doubtful cases shall be resolved in favor of coverage. For a particular product received by a particular user, “normally used” refers to a typical or common use of that class of product, regardless of the status of the particular user or of the way in which the particular user actually uses, or expects or is expected to use, the product. A product is a consumer product regardless of whether the product has substantial commercial, industrial or non-consumer uses, unless such uses represent the only significant mode of use of the product.
104
100
105
101
“Installation Information” for a User Product means any methods, procedures, authorization keys, or other information required to install and execute modified versions of a covered work in that User Product from a modified version of its Corresponding Source. The information must suffice to ensure that the continued functioning of the modified object code is in no case prevented or interfered with solely because modification has been made.
106
102
107
103
If you convey an object code work under this section in, or with, or specifically for use in, a User Product, and the conveying occurs as part of a transaction in which the right of possession and use of the User Product is transferred to the recipient in perpetuity or for a fixed term (regardless of how the transaction is characterized), the Corresponding Source conveyed under this section must be accompanied by the Installation Information. But this requirement does not apply if neither you nor any third party retains the ability to install modified object code on the User Product (for example, the work has been installed in ROM).
108
104
109
105
The requirement to provide Installation Information does not include a requirement to continue to provide support service, warranty, or updates for a work that has been modified or installed by the recipient, or for the User Product in which it has been modified or installed. Access to a network may be denied when the modification itself materially and adversely affects the operation of the network or violates the rules and protocols for communication across the network.
110
106
111
107
Corresponding Source conveyed, and Installation Information provided, in accord with this section must be in a format that is publicly documented (and with an implementation available to the public in source code form), and must require no special password or key for unpacking, reading or copying.
112
108
7. Additional Terms.
113
109
114
110
“Additional permissions” are terms that supplement the terms of this License by making exceptions from one or more of its conditions. Additional permissions that are applicable to the entire Program shall be treated as though they were included in this License, to the extent that they are valid under applicable law. If additional permissions apply only to part of the Program, that part may be used separately under those permissions, but the entire Program remains governed by this License without regard to the additional permissions.
115
111
116
112
When you convey a copy of a covered work, you may at your option remove any additional permissions from that copy, or from any part of it. (Additional permissions may be written to require their own removal in certain cases when you modify the work.) You may place additional permissions on material, added by you to a covered work, for which you have or can give appropriate copyright permission.
117
113
118
114
Notwithstanding any other provision of this License, for material you add to a covered work, you may (if authorized by the copyright holders of that material) supplement the terms of this License with terms:
119
115
120
116
    * a) Disclaiming warranty or limiting liability differently from the terms of sections 15 and 16 of this License; or
121
117
    * b) Requiring preservation of specified reasonable legal notices or author attributions in that material or in the Appropriate Legal Notices displayed by works containing it; or
122
118
    * c) Prohibiting misrepresentation of the origin of that material, or requiring that modified versions of such material be marked in reasonable ways as different from the original version; or
123
119
    * d) Limiting the use for publicity purposes of names of licensors or authors of the material; or
124
120
    * e) Declining to grant rights under trademark law for use of some trade names, trademarks, or service marks; or
125
121
    * f) Requiring indemnification of licensors and authors of that material by anyone who conveys the material (or modified versions of it) with contractual assumptions of liability to the recipient, for any liability that these contractual assumptions directly impose on those licensors and authors.
126
122
127
123
All other non-permissive additional terms are considered “further restrictions” within the meaning of section 10. If the Program as you received it, or any part of it, contains a notice stating that it is governed by this License along with a term that is a further restriction, you may remove that term. If a license document contains a further restriction but permits relicensing or conveying under this License, you may add to a covered work material governed by the terms of that license document, provided that the further restriction does not survive such relicensing or conveying.
128
124
129
125
If you add terms to a covered work in accord with this section, you must place, in the relevant source files, a statement of the additional terms that apply to those files, or a notice indicating where to find the applicable terms.
130
126
131
127
Additional terms, permissive or non-permissive, may be stated in the form of a separately written license, or stated as exceptions; the above requirements apply either way.
132
128
8. Termination.
133
129
134
130
You may not propagate or modify a covered work except as expressly provided under this License. Any attempt otherwise to propagate or modify it is void, and will automatically terminate your rights under this License (including any patent licenses granted under the third paragraph of section 11).
135
131
136
132
However, if you cease all violation of this License, then your license from a particular copyright holder is reinstated (a) provisionally, unless and until the copyright holder explicitly and finally terminates your license, and (b) permanently, if the copyright holder fails to notify you of the violation by some reasonable means prior to 60 days after the cessation.
137
133
138
134
Moreover, your license from a particular copyright holder is reinstated permanently if the copyright holder notifies you of the violation by some reasonable means, this is the first time you have received notice of violation of this License (for any work) from that copyright holder, and you cure the violation prior to 30 days after your receipt of the notice.
139
135
140
136
Termination of your rights under this section does not terminate the licenses of parties who have received copies or rights from you under this License. If your rights have been terminated and not permanently reinstated, you do not qualify to receive new licenses for the same material under section 10.
141
137
9. Acceptance Not Required for Having Copies.
142
138
143
139
You are not required to accept this License in order to receive or run a copy of the Program. Ancillary propagation of a covered work occurring solely as a consequence of using peer-to-peer transmission to receive a copy likewise does not require acceptance. However, nothing other than this License grants you permission to propagate or modify any covered work. These actions infringe copyright if you do not accept this License. Therefore, by modifying or propagating a covered work, you indicate your acceptance of this License to do so.
144
140
10. Automatic Licensing of Downstream Recipients.
145
141
146
142
Each time you convey a covered work, the recipient automatically receives a license from the original licensors, to run, modify and propagate that work, subject to this License. You are not responsible for enforcing compliance by third parties with this License.
147
143
148
144
An “entity transaction” is a transaction transferring control of an organization, or substantially all assets of one, or subdividing an organization, or merging organizations. If propagation of a covered work results from an entity transaction, each party to that transaction who receives a copy of the work also receives whatever licenses to the work the party's predecessor in interest had or could give under the previous paragraph, plus a right to possession of the Corresponding Source of the work from the predecessor in interest, if the predecessor has it or can get it with reasonable efforts.
149
145
150
146
You may not impose any further restrictions on the exercise of the rights granted or affirmed under this License. For example, you may not impose a license fee, royalty, or other charge for exercise of rights granted under this License, and you may not initiate litigation (including a cross-claim or counterclaim in a lawsuit) alleging that any patent claim is infringed by making, using, selling, offering for sale, or importing the Program or any portion of it.
151
147
11. Patents.
152
148
153
149
A “contributor” is a copyright holder who authorizes use under this License of the Program or a work on which the Program is based. The work thus licensed is called the contributor's “contributor version”.
154
150
155
151
A contributor's “essential patent claims” are all patent claims owned or controlled by the contributor, whether already acquired or hereafter acquired, that would be infringed by some manner, permitted by this License, of making, using, or selling its contributor version, but do not include claims that would be infringed only as a consequence of further modification of the contributor version. For purposes of this definition, “control” includes the right to grant patent sublicenses in a manner consistent with the requirements of this License.
156
152
157
153
Each contributor grants you a non-exclusive, worldwide, royalty-free patent license under the contributor's essential patent claims, to make, use, sell, offer for sale, import and otherwise run, modify and propagate the contents of its contributor version.
158
154
159
155
In the following three paragraphs, a “patent license” is any express agreement or commitment, however denominated, not to enforce a patent (such as an express permission to practice a patent or covenant not to sue for patent infringement). To “grant” such a patent license to a party means to make such an agreement or commitment not to enforce a patent against the party.
160
156
161
157
If you convey a covered work, knowingly relying on a patent license, and the Corresponding Source of the work is not available for anyone to copy, free of charge and under the terms of this License, through a publicly available network server or other readily accessible means, then you must either (1) cause the Corresponding Source to be so available, or (2) arrange to deprive yourself of the benefit of the patent license for this particular work, or (3) arrange, in a manner consistent with the requirements of this License, to extend the patent license to downstream recipients. “Knowingly relying” means you have actual knowledge that, but for the patent license, your conveying the covered work in a country, or your recipient's use of the covered work in a country, would infringe one or more identifiable patents in that country that you have reason to believe are valid.
162
158
163
159
If, pursuant to or in connection with a single transaction or arrangement, you convey, or propagate by procuring conveyance of, a covered work, and grant a patent license to some of the parties receiving the covered work authorizing them to use, propagate, modify or convey a specific copy of the covered work, then the patent license you grant is automatically extended to all recipients of the covered work and works based on it.
164
160
165
161
A patent license is “discriminatory” if it does not include within the scope of its coverage, prohibits the exercise of, or is conditioned on the non-exercise of one or more of the rights that are specifically granted under this License. You may not convey a covered work if you are a party to an arrangement with a third party that is in the business of distributing software, under which you make payment to the third party based on the extent of your activity of conveying the work, and under which the third party grants, to any of the parties who would receive the covered work from you, a discriminatory patent license (a) in connection with copies of the covered work conveyed by you (or copies made from those copies), or (b) primarily for and in connection with specific products or compilations that contain the covered work, unless you entered into that arrangement, or that patent license was granted, prior to 28 March 2007.
166
162
167
163
Nothing in this License shall be construed as excluding or limiting any implied license or other defenses to infringement that may otherwise be available to you under applicable patent law.
168
164
12. No Surrender of Others' Freedom.
169
165
170
166
If conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot convey a covered work so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not convey it at all. For example, if you agree to terms that obligate you to collect a royalty for further conveying from those to whom you convey the Program, the only way you could satisfy both those terms and this License would be to refrain entirely from conveying the Program.
171
167
13. Use with the GNU Affero General Public License.
172
168
173
169
Notwithstanding any other provision of this License, you have permission to link or combine any covered work with a work licensed under version 3 of the GNU Affero General Public License into a single combined work, and to convey the resulting work. The terms of this License will continue to apply to the part which is the covered work, but the special requirements of the GNU Affero General Public License, section 13, concerning interaction through a network will apply to the combination as such.
174
170
14. Revised Versions of this License.
175
171
176
172
The Free Software Foundation may publish revised and/or new versions of the GNU General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns.
177
173
178
174
Each version is given a distinguishing version number. If the Program specifies that a certain numbered version of the GNU General Public License “or any later version” applies to it, you have the option of following the terms and conditions either of that numbered version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of the GNU General Public License, you may choose any version ever published by the Free Software Foundation.
179
175
180
176
If the Program specifies that a proxy can decide which future versions of the GNU General Public License can be used, that proxy's public statement of acceptance of a version permanently authorizes you to choose that version for the Program.
181
177
182
178
Later license versions may give you additional or different permissions. However, no additional obligations are imposed on any author or copyright holder as a result of your choosing to follow a later version.
183
179
15. Disclaimer of Warranty.
184
180
185
181
THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
186
182
16. Limitation of Liability.
187
183
188
184
IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
189
185
17. Interpretation of Sections 15 and 16.
190
186
191
187
If the disclaimer of warranty and limitation of liability provided above cannot be given local legal effect according to their terms, reviewing courts shall apply local law that most closely approximates an absolute waiver of all civil liability in connection with the Program, unless a warranty or assumption of liability accompanies a copy of the Program in return for a fee.
192
188
193
189
END OF TERMS AND CONDITIONS
194
190
How to Apply These Terms to Your New Programs
195
191
196
192
If you develop a new program, and you want it to be of the greatest possible use to the public, the best way to achieve this is to make it free software which everyone can redistribute and change under these terms.
197
193
198
194
To do so, attach the following notices to the program. It is safest to attach them to the start of each source file to most effectively state the exclusion of warranty; and each file should have at least the “copyright” line and a pointer to where the full notice is found.
199
195
200
196
    <one line to give the program's name and a brief idea of what it does.>
201
197
    Copyright (C) <year>  <name of author>
202
198
203
199
    This program is free software: you can redistribute it and/or modify
204
200
    it under the terms of the GNU General Public License as published by
205
201
    the Free Software Foundation, either version 3 of the License, or
206
202
    (at your option) any later version.
207
203
208
204
    This program is distributed in the hope that it will be useful,
209
205
    but WITHOUT ANY WARRANTY; without even the implied warranty of
210
206
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
211
207
    GNU General Public License for more details.
212
208
213
209
    You should have received a copy of the GNU General Public License
214
210
    along with this program.  If not, see <http://www.gnu.org/licenses/>.
215
211
216
212
Also add information on how to contact you by electronic and paper mail.
217
213
218
214
If the program does terminal interaction, make it output a short notice like this when it starts in an interactive mode:
219
215
220
216
    <program>  Copyright (C) <year>  <name of author>
221
217
    This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
222
218
    This is free software, and you are welcome to redistribute it
223
219
    under certain conditions; type `show c' for details.
224
220
225
221
The hypothetical commands `show w' and `show c' should show the appropriate parts of the General Public License. Of course, your program's commands might be different; for a GUI interface, you would use an “about box”.
226
222
227
223
You should also get your employer (if you work as a programmer) or school, if any, to sign a “copyright disclaimer” for the program, if necessary. For more information on this, and how to apply and follow the GNU GPL, see <http://www.gnu.org/licenses/>.
228
224
229
225
The GNU General Public License does not permit incorporating your program into proprietary programs. If your program is a subroutine library, you may consider it more useful to permit linking proprietary applications with the library. If this is what you want to do, use the GNU Lesser General Public License instead of this License. But first, please read <http://www.gnu.org/philosophy/why-not-lgpl.html>.
230
0
226
231
=== added file 'NEWS.convto'
232
--- NEWS.convto	1970-01-01 00:00:00 +0000
233
+++ NEWS.convto	2009-03-17 00:18:17 +0000
234
@@ -0,0 +1,5 @@
235
1
###############################################################################
236
2
mardi 17 mars 2009, 00:02:26 (UTC+0100)
237
3
###############################################################################
238
4
Ajout du traitement récursif
239
5
240
0
6
241
=== added file 'TODO'
242
--- TODO	1970-01-01 00:00:00 +0000
243
+++ TODO	2009-03-17 01:34:59 +0000
244
@@ -0,0 +1,14 @@
245
1
###############################################################################
246
2
mardi 17 mars 2009, 00:02:26 (UTC+0100)
247
3
###############################################################################
248
4
Fidji
249
5
Trouver un vimrc pour scripts et bzr si ça existe
250
6
251
7
###############################################################################
252
8
vendredi 13 mars 2009, 06:06:31 (UTC+0100)
253
9
###############################################################################
254
10
Fidji
255
11
Ajouter un script de création de playtlists
256
12
find ~/music/ -iname "*.mp3" -print > ~/Desktop/playlist.m3u
257
13
  * Choix de création d'une playlist par dossier et ou générale
258
14
  * Choix des types de fichiers
259
0
15
260
=== added file 'TODO.convto'
261
--- TODO.convto	1970-01-01 00:00:00 +0000
262
+++ TODO.convto	2009-03-17 00:18:17 +0000
263
@@ -0,0 +1,34 @@
264
1
###############################################################################
265
2
mardi 17 mars 2009, 00:02:26 (UTC+0100)
266
3
###############################################################################
267
4
Tester les modifications prenant en compte le traitement récursif
268
5
Utiliser le modèle POD de Mathias
269
6
Standardiser l'usage du .sh
270
7
Intégrer l'option pour :
271
8
	suppressions des blanc dans les noms de fichiers
272
9
	supprimer les accents
273
10
	supprimer les .#~ et autres caractères
274
11
	Minuscule/Majuscule
275
12
	Création d'un playlist
276
13
	convertir en utf8 ou autre charset
277
14
Trouver un vimrc pour scripts et bzr si ça existe
278
15
279
16
280
17
###############################################################################
281
18
vendredi 13 mars 2009, 06:06:31 (UTC+0100)
282
19
###############################################################################
283
20
Ajouter la prise en charge d'autres formats audio
284
21
Ajouter une option pour supprimer la source une fois convertie
285
22
Intégrer le traitement récursif sur les répertoires
286
23
Ajouter une option pour ajuster la qualité des mp3 (défaut 192)
287
24
288
25
###############################################################################
289
26
Jeudi 12 mars 2009, 08:01:24 (UTC+0100)
290
27
###############################################################################
291
28
Intégrer le traitement récursif sur les dossiers
292
29
Tests de conversion ogg <-> mp3
293
30
294
31
convto mp3 *.ogg # ok
295
32
convto ogg *.mp3 # ok
296
33
convto ogg . # Erreur
297
34
convto mp3 . # Erreur
298
0
35
299
=== added file 'TODO.mp3gainize'
300
--- TODO.mp3gainize	1970-01-01 00:00:00 +0000
301
+++ TODO.mp3gainize	2009-03-13 05:19:32 +0000
302
@@ -0,0 +1,6 @@
303
1
###############################################################################
304
2
vendredi 13 mars 2009, 06:06:31 (UTC+0100)
305
3
###############################################################################
306
4
Adapter le script en prenant pour modèle le script convto
307
5
Traitement par défaut par album, ajouter un fichier de configuration pour solo
308
6
309
0
7
310
=== added file 'TODO.playdir'
311
--- TODO.playdir	1970-01-01 00:00:00 +0000
312
+++ TODO.playdir	2009-03-13 05:36:10 +0000
313
@@ -0,0 +1,6 @@
314
1
###############################################################################
315
2
vendredi 13 mars 2009, 06:06:31 (UTC+0100)
316
3
###############################################################################
317
4
Ajouter la prise en charge d'autres formats audio
318
5
Intégrer le traitement récursif sur les répertoires
319
6
320
0
7
321
=== added file 'audio_convertor'
322
--- audio_convertor	1970-01-01 00:00:00 +0000
323
+++ audio_convertor	2009-03-12 16:54:50 +0000
324
@@ -0,0 +1,103 @@
325
1
#!/bin/bash
326
2
# Auteur : Etienne Gadeski
327
3
#       This program is free software; you can redistribute it and/or modify
328
4
#       it under the terms of the GNU General Public License as published by
329
5
#       the Free Software Foundation; either version 2 of the License, or
330
6
#       (at your option) any later version.
331
7
#       
332
8
#       This program is distributed in the hope that it will be useful,
333
9
#       but WITHOUT ANY WARRANTY; without even the implied warranty of
334
10
#       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
335
11
#       GNU General Public License for more details.
336
12
#       
337
13
#       You should have received a copy of the GNU General Public License
338
14
#       along with this program; if not, write to the Free Software
339
15
#       Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
340
16
#       MA 02110-1301, USA.
341
17
#
342
18
# Désolé pour la suppression du script... Mea culpa, Mea maxima culpa
343
19
# usage : audio_convertor [ -r (recursif) | -d (dossier) ] ogg2mp3 | mp32ogg fichier | dossier
344
20
gethelp() {
345
21
    echo "${0##*/} [ -r (recursif) | -d (dossier) ] ogg2mp3 | mp32ogg fichier | dossier"
346
22
}
347
23
348
24
#---testdir effectue des test sur le dossier a traiter
349
25
testdir() {
350
26
    if [ ! -d "$1" ] ; then 
351
27
        echo "Dossier invalide"
352
28
	echo
353
29
	gethelp
354
30
        return 1
355
31
    elif [ ! -r "$1" ] ; then
356
32
        echo "Dossier invalide"
357
33
	echo
358
34
	gethelp
359
35
        return 2
360
36
    elif [ ! -w "$1" ] ; then 
361
37
        echo "Dossier invalide"
362
38
	gethelp
363
39
        return 3
364
40
    else
365
41
        return 0
366
42
    fi
367
43
}
368
44
369
45
#---testfic effectue des test sur le fichier a traiter
370
46
testfic() {
371
47
    if [ ! -f "$1" ] ; then 
372
48
        echo "Fichier invalide"
373
49
        echo
374
50
        gethelp
375
51
        return 1
376
52
    elif [ ! -r "$1" ] ; then 
377
53
        echo "Fichier invalide"
378
54
        echo
379
55
        gethelp
380
56
        return 2
381
57
    elif [ ! -w "$PWD" ] ; then 
382
58
        echo "Ne peut ecrire dans $PWD"
383
59
        echo
384
60
        gethelp
385
61
        return 3
386
62
    else 
387
63
        return 0
388
64
    fi
389
65
}
390
66
[ "$#" -eq 0 ] && echo "Parametres insuffisants" && exit 1
391
67
MODE=solo
392
68
until [ "$#" -eq 0 ] ; do # tant qu'il y a des parametres
393
69
    case "$1" in 
394
70
        mp32ogg) OPTMP3="--"
395
71
                 FROM=mp3
396
72
                 TO=ogg;;
397
73
        ogg2mp3) OPTMP3="-ab 192k"
398
74
                 FROM=ogg
399
75
                 TO=mp3;;
400
76
        -r) MODE=recursif;;
401
77
        -d) MODE=dossier;;
402
78
        -h|--help) gethelp;;
403
79
        *) case "$MODE" in 
404
80
           recursif) testdir "$1" && \
405
81
                    while read -d $'\0' "fic"
406
82
                    do
407
83
                        ffmpeg -i "$fic" "$OPTMP3" "${fic%.${FROM}}.${TO}" >/dev/null 2>&1
408
84
                    done < <(find "$1" -name "*.${FROM}" -print0)
409
85
                    ;;
410
86
           dossier)
411
87
                    testdir "$1" && \
412
88
                    fichiers=($1/*.${FROM})
413
89
                    dialog --gauge "Conversion en cours, veuillez patienter..." 20 75 < <( # créé une barre de progres
414
90
                    n=${#fichiers[*]}; i=0
415
91
                    for fic in "${fichiers[@]}"; do
416
92
                        ffmpeg -i "$fic" "$OPTMP3" "${fic%.${FROM}}.${TO}" >/dev/null 2>&1 
417
93
                        echo $((100*(++i)/n))
418
94
                    done)
419
95
                    ;;
420
96
            solo) testfic "$1" && \
421
97
                  ffmpeg  -i "$1" "$OPTMP3" "${1%.${FROM}}.${TO}"
422
98
                  ;;
423
99
            *);;
424
100
            esac;;
425
101
    esac
426
102
    shift
427
103
done
428
0
104
429
=== added file 'convto'
430
--- convto	1970-01-01 00:00:00 +0000
431
+++ convto	2009-03-21 03:44:44 +0000
432
@@ -0,0 +1,136 @@
433
1
#!/bin/bash
434
2
#
435
3
# Auteur     : Etienne Gadeski
436
4
# Adaptation : Jean-Michel Juzan
437
5
# 
438
6
#       This program is free software; you can redistribute it and/or modify
439
7
#       it under the terms of the GNU General Public License as published by
440
8
#       the Free Software Foundation; either version 2 of the License, or
441
9
#       (at your option) any later version.
442
10
#       
443
11
#       This program is distributed in the hope that it will be useful,
444
12
#       but WITHOUT ANY WARRANTY; without even the implied warranty of
445
13
#       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
446
14
#       GNU General Public License for more details.
447
15
#       
448
16
#       You should have received a copy of the GNU General Public License
449
17
#       along with this program; if not, write to the Free Software
450
18
#       Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
451
19
#       MA 02110-1301, USA.
452
20
#
453
21
# for i in *.wma; do ffmpeg -i "$i" -ab 256k "${i%wma}mp3"; done
454
22
#
455
23
usage="Usage: ${0##*/} [ OPTION ]...[ FICHIER | DESTINATION ]..."
456
24
aide="${usage}\
457
25
Convertir les fichiers mp3 en ogg et inversement\
458
26
  -r   traitement récursif\
459
27
  ogg  converti en ogg\
460
28
  mp3  converti en mp3\
461
29
  -h --help cette aide"
462
30
463
31
# Fonctions
464
32
# Affiche les messages
465
33
getmsg() {
466
34
	echo ${msg}
467
35
	echo  
468
36
}
469
37
470
38
#---testdir effectue des test sur le dossier a traiter
471
39
testdir() {
472
40
    if [ ! -d "${rep}" ] ; then 
473
41
        echo "${rep} n'est pas un répertoire"
474
42
	echo
475
43
        return 1
476
44
    elif [ ! -r "${rep}" ] ; then
477
45
        echo "${rep} n'est pas accessible en lecture"
478
46
	echo
479
47
        return 2
480
48
    elif [ ! -w "${rep}" ] ; then 
481
49
        echo "${rep} n'est pas accessible en écriture"
482
50
	echo
483
51
        return 3
484
52
    else
485
53
        return 0
486
54
    fi
487
55
}
488
56
489
57
#---testfic effectue des test sur le fichier a traiter
490
58
testfic() {
491
59
    if [ ! -f "${fic}" ] ; then 
492
60
        echo "${fic} n'est pas un fichier valide"
493
61
        echo
494
62
        return 1
495
63
    elif [ ! -r "${fic}" ] ; then 
496
64
        echo "${fic} n'est pas accessible en lecture"
497
65
        echo
498
66
        return 2
499
67
    elif [ ! -w "${PWD}" ] ; then 
500
68
        echo "Ne peut ecrire dans ${PWD}"
501
69
        echo
502
70
        return 3
503
71
    else 
504
72
        return 0
505
73
    fi
506
74
}
507
75
dofic() {
508
76
	testfic && \
509
77
	ffmpeg -i "${fic}" ${OPTMP3} "${fic%.${FROM}}.${TO}" #>/dev/null 2>&1
510
78
	return 0
511
79
}
512
80
513
81
dorep() {
514
82
	rep=${1}
515
83
        testdir && \
516
84
        fichiers=("${rep}/"*.${FROM})
517
85
        # Barre de progression
518
86
        dialog --gauge "Conversion de ${rep} en cours, veuillez patienter..." 20 75 < <(
519
87
        n=${#fichiers[*]}
520
88
        if [ ! "${n}" ] ; then
521
89
        	msg="Aucun fichier à traiter"
522
90
                getmsg
523
91
		return 1
524
92
        fi
525
93
        i=0
526
94
        for fic in "${fichiers[@]}"; do
527
95
        	dofic
528
96
                echo $((100*(++i)/n))
529
97
        done
530
98
        #)
531
99
	return 0
532
100
}
533
101
534
102
# main
535
103
# S'il n'y a pas de paramètre
536
104
[ "$#" -eq 0 ] && msg=$usage && getmsg && exit 1
537
105
MODE=solo
538
106
OPTMP3=""
539
107
540
108
until [ "$#" -eq 0 ] ; do # tant qu'il y a des parametres
541
109
    case "$1" in 
542
110
        ogg)       
543
111
                   FROM=mp3
544
112
                   TO=ogg;;
545
113
        mp3)       FROM=ogg
546
114
                   OPTMP3="-ab 192k"
547
115
                   TO=mp3;;
548
116
        -r)        MODE=recursif;;
549
117
        -h|--help) msg=$aide
550
118
                   getmsg;;
551
119
        *)         if [ -f "${1}" ] ; then # Si c'est un fichier
552
120
                     fic="${1}"
553
121
                     dofic 
554
122
                   fi 
555
123
                   if  [ -d "${1}" ] ; then # Si c'est un répertoire
556
124
                     if [ ${MODE} = "recursif" ] ; then
557
125
                       	 find "${1}" -type d | while read frep
558
126
                         do
559
127
                            dorep "${frep}"
560
128
                         done
561
129
                     else 
562
130
                         dorep "${1}"
563
131
                     fi
564
132
                   fi   
565
133
                   ;;
566
134
    esac
567
135
    shift
568
136
done
569
0
137
570
=== added file 'convto.sh'
571
--- convto.sh	1970-01-01 00:00:00 +0000
572
+++ convto.sh	2009-03-21 03:44:44 +0000
573
@@ -0,0 +1,230 @@
574
1
#!/bin/bash
575
2
#
576
3
# Auteur(s) :
577
4
#  
578
5
# Maintenu par l'équipe ubuntu-fr-script
579
6
# https://launchpad.net/~ubuntu-fr-scripts
580
7
#
581
8
#       This program is free software; you can redistribute it and/or modify
582
9
#       it under the terms of the GNU General Public License as published by
583
10
#       the Free Software Foundation; either version 2 of the License, or
584
11
#       (at your option) any later version.
585
12
#
586
13
#       This program is distributed in the hope that it will be useful,
587
14
#       but WITHOUT ANY WARRANTY; without even the implied warranty of
588
15
#       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
589
16
#       GNU General Public License for more details.
590
17
#
591
18
#       You should have received a copy of the GNU General Public License
592
19
#       along with this program; if not, write to the Free Software
593
20
#       Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
594
21
#       MA 02110-1301, USA.
595
22
#
596
23
597
24
###############################################################################
598
25
# Variables
599
26
###############################################################################
600
27
# Commandes builtin
601
28
#------------------
602
29
CMD_EVAL="builtin eval"
603
30
CMD_EXIT="builtin exit"
604
31
605
32
# Commandes UNIX standards
606
33
#------------------------
607
34
CMD_BASENAME="basename"
608
35
CMD_DIRNAME="dirname"
609
36
CMD_SED="sed"
610
37
CMD_GREP="grep"
611
38
612
39
# Autres commandes
613
40
#----------------
614
41
CMD_PERL="perl"
615
42
616
43
617
44
CMD_PRINT_SHORT_HELP="$CMD_EVAL $CMD_PERL -e 'use Pod::Usage; pod2usage(-verbose=>0,-input=>\$ARGV[0])' `$CMD_BASENAME $0`"
618
45
CMD_PRINT_HELP="$CMD_EVAL $CMD_PERL -e 'use Pod::Usage; pod2usage(-verbose=>1,-input=>\$ARGV[0])' `$CMD_BASENAME $0`"
619
46
CMD_PRINT_MANPAGE="$CMD_EVAL $CMD_PERL -e 'use Pod::Usage; pod2usage(-verbose=>2,-input=>\$ARGV[0])' `$CMD_BASENAME $0`"
620
47
621
48
# Vous pouvez ici ajouter vos variables
622
49
623
50
###############################################################################
624
51
# Fonctions
625
52
###############################################################################
626
53
627
54
#----------------------------------------------------------------------
628
55
# analyseLigneCommande
629
56
#    analyse les paramètres de la ligne de commande
630
57
# 
631
58
# entrée:
632
59
#    - les paramètres de la ligne de commande à analyser
633
60
# note:
634
61
#    - rien
635
62
# retour:
636
63
#    - rien
637
64
#
638
65
#----------------------------------------------------------------------
639
66
function analyseLigneCommande()
640
67
{
641
68
   while getopts "hm" Option
642
69
   do
643
70
      case $Option in
644
71
         h ) $CMD_PRINT_HELP
645
72
	     $CMD_EXIT
646
73
	     ;;
647
74
         m ) $CMD_PRINT_MANPAGE
648
75
	     $CMD_EXIT
649
76
	     ;;
650
77
         * ) $CMD_PRINT_SHORT_HELP
651
78
	     $CMD_EXIT 1
652
79
	     ;;
653
80
      esac
654
81
   done
655
82
}
656
83
657
84
# Vous pouvez ajouter ici vos fonctions
658
85
659
86
###############################################################################
660
87
# MAIN
661
88
###############################################################################
662
89
analyseLigneCommande "$@"
663
90
664
91
# Vous pouver ajouter ici le programme principal (main)
665
92
666
93
667
94
# Dans la section POD Ajouter les informations nécessaire à la création
668
95
# de la page de manuel et la page html
669
96
#
670
97
# POD section -----------------------------------------------------------------
671
98
672
99
: <<=cut
673
100
674
101
=pod
675
102
676
103
=head1 NOM
677
104
678
105
monscript.sh - Le programme fait ceci et cela...
679
106
680
107
=head1 SYNOPSIS
681
108
682
109
Un cours résumé de l'usage du script.
683
110
684
111
B<monscript.sh> { B<ceci>|B<cela> } [ B<-flags> ] [ B<-o> I<option> ] I<argument> [ I<plus...> ]
685
112
686
113
=head1 DESCRIPTION
687
114
688
115
Longue description du script et de ses possibilités. C'est une bonne idée de diviser en sous chapître cette partie.
689
116
En utilisant "=head2" de cette manière
690
117
691
118
=head2 Un exemple de sous chapître
692
119
693
120
=head2 Un autre exemple de sous chapître
694
121
695
122
Les références à propos de foo(1) (ou autre) page de manuel, peuvent être écrit normallement
696
123
comme ici; B<pod2man> Nous invitons à utiliser le bon format . Utilisez S<L><>
697
124
(e.g. L<foo(SECTION)>) si vous souhaitez forcer cela.
698
125
699
126
Les paragraphes sont séparés par des lignes vide.
700
127
701
128
=head1 OPTIONS
702
129
703
130
Certaines personnes sépare ceci de la description.
704
131
705
132
Le style suivant est le plus utilisé pour documenter les options:
706
133
707
134
=over 8
708
135
709
136
=item B<ceci>|B<cela>
710
137
711
138
L'utilisateur doit explicitement spécifier B<ceci> ou B<cela> pour pouvoir exécuter le script.
712
139
Les accolades { et } indique que ce qui est à l'intérieur est requis. La barre | sépare des options exclusives.
713
140
(i.e. Vous ne pouvez pas avoir les deux à la fois).
714
141
715
142
=item B<-o> I<option>
716
143
717
144
Passe l'I<option> fournit par l'utilisateur à B<monscript.sh> pour changer son comportement.
718
145
Le fait que l'I<option> soit souligné ou en italique veut dire que l'utilisateur la remplace
719
146
par une valeur valide pour cette option. Les crochets [ et ] indique qu'elle n'est pas obligatoire.
720
147
721
148
=item I<argument>
722
149
723
150
Le dernier I<argument> est requis, parce qu'il n'est pas entre crochets.
724
151
725
152
=item I<plus>
726
153
727
154
indique que l'utilisateur peut optionnelement ajouter d'autre argument à la fin.
728
155
Les (...) indique qu'un ou plus the paramètre est autorisé.
729
156
730
157
=back
731
158
732
159
=head1 VALEUR DE RETOUR
733
160
734
161
Ce que le script renvoie comme valeur en cas de succès.
735
162
736
163
=head1 ERREURS
737
164
738
165
Code de retours d'erreurs.
739
166
740
167
=head1 EXEMPLES
741
168
742
169
Donner quelques exemples d'utilisation du script.
743
170
744
171
=head1 ENVIRONEMENT
745
172
746
173
Des variables d'environement qui affecte le script.
747
174
748
175
=head1 FICHIERS
749
176
750
177
Tous les fichiers utilisés par le script. Un usage typique est comme ceci:
751
178
752
179
=over 8
753
180
754
181
=item F</usr/man>
755
182
756
183
répertoire du man par défaut
757
184
758
185
=item F</usr/man/man*/*.*>
759
186
760
187
pages de man non formatées
761
188
762
189
=back
763
190
764
191
=head1 NOTES
765
192
766
193
Des commentaires généraux.
767
194
768
195
=head1 CAVEATS
769
196
770
197
Des points auxquels il faut prêter attention, parfois appelé WARNINGS.
771
198
772
199
=head1 DIAGNOSTICS
773
200
774
201
Tous les messages d'erreurs possibles que le script peut afficher,
775
202
ce qu'ils veulent dire et comment les corriger si c'est possible.
776
203
777
204
=head1 BUGS
778
205
779
206
Des choses qui sont cassés ou qui ne fontionne pas bien.
780
207
781
208
=head1 RESTRICTIONS
782
209
783
210
Des bugs que vous ne planifiez pas de corriger :-)
784
211
785
212
=head1 AUTEUR
786
213
787
214
Qui l'a écrit (ou AUTEURS s'il y en a plusieurs)
788
215
789
216
Cette exemple a été construit par Colin Watson <S<cjwatson@debian.org>>
790
217
sur un template fournit par Tom Christiansen <S<tchrist@jhereg.perl.com>>.
791
218
792
219
=head1 HISTORIQUE
793
220
794
221
Certain programmes dérivés d'autre sources ont parfois cette section.
795
222
796
223
=head1 VOIR AUSSI
797
224
798
225
D'autre pages man à voir, comme man(1), man(7), mandb(8), catman(8).
799
226
800
227
Pour cette exemple, voir pod2man(1) pour plus de détails.
801
228
802
229
=cut
803
230
804
0
231
805
=== added file 'm4a2mp3.sh'
806
--- m4a2mp3.sh	1970-01-01 00:00:00 +0000
807
+++ m4a2mp3.sh	2009-03-16 19:22:21 +0000
808
@@ -0,0 +1,19 @@
809
1
#!/bin/bash
810
2
# m4a2mp3.sh - By pmd - http://pmdz.info
811
3
# But : Convertir des fichiers m4a/aac vers mp3
812
4
# Paquets requis : faad lame
813
5
# Licence : http://creativecommons.org/licenses/by-nc-sa/2.0/fr/
814
6
#           Paternité - Pas d'Utilisation Commerciale - Partage des Conditions Initiales à l'Identique
815
7
816
8
# Pour tous les fichiers se terminant par .m4a
817
9
for i in *.m4a
818
10
do
819
11
# m4a vers wav
820
12
faad "$i"
821
13
x=`echo "$i"|sed -e 's/.m4a/.wav/'`
822
14
y=`echo "$i"|sed -e 's/.m4a/.mp3/'`
823
15
# wav vers mp3
824
16
lame -h -b 192 "$x" "$y"
825
17
rm "$x"
826
18
rm "$i"
827
19
done
828
0
20
829
=== added file 'mp3gainize'
830
--- mp3gainize	1970-01-01 00:00:00 +0000
831
+++ mp3gainize	2009-03-13 03:42:32 +0000
832
@@ -0,0 +1,175 @@
833
1
#!/bin/bash
834
2
# $Id$
835
3
# Ce script demande un grand coup de balai !
836
4
837
5
# Valeur par defaut :
838
6
dstdir="${HOME}/data/musique"
839
7
tmpdir="${HOME}/tmp"
840
8
suffix="mp3"
841
9
842
10
debug=0
843
11
muet=0
844
12
bavard=0
845
13
recursif=0
846
14
type="solo"
847
15
typesrc=""
848
16
849
17
############## FONCTIONS ################
850
18
851
19
function gainonfile()
852
20
{
853
21
	test ${debug} -eq 1 && echo -e "gainonfile: Chemin de travail : ${PWD}"
854
22
	mp3gain -c "$1"
855
23
}
856
24
function gainondir()
857
25
{
858
26
	test ${debug} -eq 1 && echo -e "gainondir: Chemin de travail : ${PWD}"
859
27
	test ${debug} -eq 0 && echo -e "Chemin de travail : ${PWD}"
860
28
	mp3ici=`find . -type f -maxdepth 1 -iregex '.*\.[Mm][Pp]3'`
861
29
	test -z "${mp3ici}" && return
862
30
	mp3gain -c -a *.[Mm][Pp]3
863
31
}
864
32
function testdir()
865
33
{
866
34
	test ${debug} -eq 1 && echo -e "testdir: Verifie les droits du repertoire $1"
867
35
	wok=1 # Par defaut le repertoire doit etre en ecriture
868
36
	# Si nous ne pouvons pas ecrire en mode muet sortie
869
37
	test ${muet} -eq 1 && test ! -w "$1" && wok=0 &&
870
38
	echo -e "Impossible d'ecrire dans le repertoire $1" &&
871
39
	kdialog --passivepopup "Impossible d'ecrire dans le repertoire $1" 3 &&
872
40
	return
873
41
874
42
	dstdir="$1"
875
43
	while test ! -w "${dstdir}"
876
44
	do
877
45
		kdialog --error "Vous n'avez pas le droit d'ecrire dans le repertoire ${dstdir}"
878
46
		dstdir=$(kdialog --title "Choisissez un autre repertoire" --getexistingdirectory $dstdir)
879
47
		test -z ${dstdir} && echo -e "Annulation de l'execution demandee ${dstdir}" && wok=0 && exit
880
48
		test ${debug} -eq 1 && echo -e "testdir: Chemin de travail choisi : ${dstdir}"
881
49
	done
882
50
	cd "${dstdir}"
883
51
}
884
52
function solo()
885
53
{
886
54
	find . -type f -maxdepth 1 -iregex '.*\.[Mm][Pp]3' | while read FICH
887
55
	do
888
56
		gainonfile "$FICH"
889
57
	done
890
58
}
891
59
function exectype()
892
60
{
893
61
	case "$type" in
894
62
		solo)
895
63
			test ${bavard} -eq 1 && echo -e "Traitement solo ${PWD}"
896
64
			solo;;
897
65
		album)
898
66
			test ${bavard} -eq 1 && echo -e "Traitement album ${PWD}"
899
67
			gainondir;;
900
68
		*) echo -e "Type ($type) inconnu, pas de traitement";;
901
69
	esac
902
70
903
71
}
904
72
############## MAIN ################
905
73
906
74
# S'il n'y a aucun parametre, sortie de la commande en invoquant l'affichage de l'aide
907
75
test -z "$1" && $0 -h && exit 1
908
76
lcparam="$@"
909
77
nbparam="$#"
910
78
#echo -e "$?"
911
79
#echo -e "$-"
912
80
cpid="$$"
913
81
#echo -e "$!"
914
82
915
83
until [ -f "$1" ] || [ -d "$1" ]
916
84
do
917
85
	case "$1" in
918
86
		-muet)
919
87
			muet=1;;
920
88
		-debug)
921
89
			debug=1;;
922
90
		-t) shift;
923
91
			type="$1";;
924
92
		-h) echo -e "\nusage:\n
925
93
$0 [-muet -v] fichier_1 fichier_n
926
94
$0 [-muet -v -r] repertoire_1 repertoire_n
927
95
$0 [-muet -v -r -t album|solo ] repertoire_1 repertoire_n
928
96
929
97
Formats possible en entree sont : mp3 
930
98
Formats possible en sortie sont : mp3
931
99
";exit;;
932
100
                -v)
933
101
                        bavard=1;;
934
102
		-r)
935
103
			recursif=1;;
936
104
                *) # Tout les parametres sont passes, ceux-ci devraient etre des fichiers ou dossiers
937
105
		if [ -f $1 ]
938
106
			then typesrc="f"
939
107
		elif [ -d $1 ]
940
108
			then typesrc="d"
941
109
		else
942
110
			echo -e "Ce n'est pas un fichier, ni un dossier, c'est quoi ce binz !!!"
943
111
			exit
944
112
		fi
945
113
                        ;;
946
114
	esac
947
115
	shift
948
116
done
949
117
950
118
# Lire les valeurs enregistrees
951
119
test ${bavard} -eq 1 && echo -e "Lecture des parametres : $(kde-config --localprefix)/share/config/mp3gainrc"
952
120
source "$(kde-config --localprefix)/share/config/mp3gainrc"
953
121
954
122
# sauvegarde des variables seulement en mode normal
955
123
test $muet -eq 0 &&
956
124
(
957
125
test ${bavard} -eq 1 && echo -e "Enregistrement des parametres : $(kde-config --localprefix)/share/config/mp3gainrc"
958
126
echo "dstdir=${dstdir}" > $(kde-config --localprefix)/share/config/mp3gainrc
959
127
echo "tmpdir=${tmpdir}" >> $(kde-config --localprefix)/share/config/mp3gainrc
960
128
echo "suffix=${suffix}" >> $(kde-config --localprefix)/share/config/mp3gainrc
961
129
)
962
130
until [ -z "$1" ]  # Tant qu'il y a des parametres...
963
131
do
964
132
	if [ -f "$1" ] # Fichiers
965
133
	then
966
134
		# MP3
967
135
		if [ "$(echo $1|sed 's/\.[Mm][Pp]3$//g')" != "$1" ]
968
136
		then
969
137
			gainonfile "$1"
970
138
		fi
971
139
	fi
972
140
	
973
141
	if [ -d "$1" ] # Repertoire
974
142
	then
975
143
		cd "$1" # on se deplace dans le repertoire
976
144
		CDIR="$PWD"
977
145
		export EXTRABASE=$(basename "$PWD") # nom du repertoire sans le chemin
978
146
		
979
147
		if [ $recursif = 0 ]
980
148
		then
981
149
			echo -e "Traitement (non recursif) de $PWD"
982
150
			testdir "$PWD"
983
151
			test $wok -eq 0 && echo -e "Impossible d'ecrire dans le repertoire : ${PWD}" && exit
984
152
			test ${bavard} -eq 1 && echo -e "chemin apres test ${dstdir}"
985
153
			exectype
986
154
			
987
155
		else
988
156
			echo -e "Traitement (recursif) de $PWD"
989
157
			 find . -type d | while read DICH # Cherche tout les sous-repertoires
990
158
			do # debut de la recursion dans le repertoire
991
159
				curdir="${CDIR}/${DICH}"
992
160
				test ${bavard} -eq 1 && echo -e "Lancemment de mp3gain sur ${curdir}"
993
161
				testdir "${curdir}"
994
162
				test $wok -eq 0 && echo -e "Impossible d'ecrire dans le repertoire : $PWD" && exit
995
163
				test ${bavard} -eq 1 && echo -e "chemin apres testdir $dstdir"
996
164
				exectype
997
165
			done
998
166
		fi
999
167
		
1000
168
	fi
1001
169
shift
1002
170
done
1003
171
test ${bavard} -eq 1 && echo -e "mp3gain termine (PPID:${PPID} PID:${cpid}) en ${SECONDS}s !\n"
1004
172
test ${bavard} -eq 0 && echo -e "mp3gain termine!\n"
1005
173
test $muet -eq 0 && kdialog --msgbox "mp3gain termine (PID:${cpid}) en ${SECONDS}s !"
1006
174
test $muet -eq 1 && kdialog --passivepopup "mp3gain termine (PID:${cpid}) en ${SECONDS}s !" 3 &
1007
175
exit
1008
0
176
1009
=== added file 'mpc2mp3.sh'
1010
--- mpc2mp3.sh	1970-01-01 00:00:00 +0000
1011
+++ mpc2mp3.sh	2009-03-16 19:22:21 +0000
1012
@@ -0,0 +1,19 @@
1013
1
#!/bin/bash
1014
2
# mpc2mp3.sh - By pmd - http://pmdz.info
1015
3
# But : Convertir des fichiers mpc vers mp3
1016
4
# Paquets requis : mpc123 lame
1017
5
# Licence : http://creativecommons.org/licenses/by-nc-sa/2.0/fr/
1018
6
#           Paternité - Pas d'Utilisation Commerciale - Partage des Conditions Initiales à l'Identique
1019
7
1020
8
# Pour tous les fichiers se terminant par .mpc
1021
9
for i in *.mpc
1022
10
do
1023
11
# mpc vers wav
1024
12
x=`echo "$i"|sed -e 's/.mpc/.wav/'`
1025
13
mpc123 -w "$x" "$i"
1026
14
y=`echo "$i"|sed -e 's/.mpc/.mp3/'`
1027
15
# wav vers mp3
1028
16
lame -h -b 192 "$x" "$y"
1029
17
rm "$x"
1030
18
rm "$i"
1031
19
done
1032
0
20
1033
=== added file 'ogg2mp3.sh'
1034
--- ogg2mp3.sh	1970-01-01 00:00:00 +0000
1035
+++ ogg2mp3.sh	2009-03-16 19:22:21 +0000
1036
@@ -0,0 +1,19 @@
1037
1
#!/bin/bash
1038
2
# ogg2mp3.sh - By pmd - http://pmdz.info
1039
3
# But : Convertir des fichiers ogg vers mp3
1040
4
# Paquets requis : vorbis-tools lame
1041
5
# Licence : http://creativecommons.org/licenses/by-nc-sa/2.0/fr/
1042
6
#           Paternité - Pas d'Utilisation Commerciale - Partage des Conditions Initiales à l'Identique
1043
7
1044
8
# Pour tous les fichiers se terminant par .ogg
1045
9
for i in *.ogg;
1046
10
do
1047
11
# ogg vers wav
1048
12
x=`echo "$i"|sed -e 's/.ogg/.wav/'`
1049
13
y=`echo "$i"|sed -e 's/.ogg/.mp3/'`
1050
14
oggdec -o "$x" "$i"
1051
15
# wav vers mp3
1052
16
lame -h -b 192 "$x" "$y"
1053
17
rm "$x"
1054
18
rm "$i"
1055
19
done
1056
0
20
1057
=== added file 'playdir'
1058
--- playdir	1970-01-01 00:00:00 +0000
1059
+++ playdir	2009-03-13 05:36:10 +0000
1060
@@ -0,0 +1,22 @@
1061
1
#!/bin/bash
1062
2
#
1063
3
# Auteur : Juzan Jean-Michel
1064
4
#
1065
5
#       This program is free software; you can redistribute it and/or modify
1066
6
#       it under the terms of the GNU General Public License as published by
1067
7
#       the Free Software Foundation; either version 2 of the License, or
1068
8
#       (at your option) any later version.
1069
9
#
1070
10
#       This program is distributed in the hope that it will be useful,
1071
11
#       but WITHOUT ANY WARRANTY; without even the implied warranty of
1072
12
#       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
1073
13
#       GNU General Public License for more details.
1074
14
#
1075
15
#       You should have received a copy of the GNU General Public License
1076
16
#       along with this program; if not, write to the Free Software
1077
17
#       Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
1078
18
#       MA 02110-1301, USA.
1079
19
#
1080
20
# Joue l'un parès l'autre tous les fichiers mp3 du repertoire
1081
21
#
1082
22
for i in *.mp3 do ; play "$i" ; done
1083
0
23
1084
=== added file 'wma2mp3.sh'
1085
--- wma2mp3.sh	1970-01-01 00:00:00 +0000
1086
+++ wma2mp3.sh	2009-03-16 19:22:21 +0000
1087
@@ -0,0 +1,19 @@
1088
1
#!/bin/bash
1089
2
# wma2mp3.sh - By pmd - http://pmdz.info
1090
3
# But : Convertir des fichiers wma vers mp3
1091
4
# Paquets requis : mplayer lame
1092
5
# Licence : http://creativecommons.org/licenses/by-nc-sa/2.0/fr/
1093
6
#           Paternité - Pas d'Utilisation Commerciale - Partage des Conditions Initiales à l'Identique
1094
7
1095
8
# Pour tous les fichiers se terminant par .wma
1096
9
for i in *.wma;
1097
10
do
1098
11
# m4a vers wav
1099
12
x=`echo "$i"|sed -e 's/.wma/.wav/'`
1100
13
y=`echo "$i"|sed -e 's/.wma/.mp3/'`
1101
14
mplayer "$i" -ao pcm:file="$x";
1102
15
# wav vers mp3
1103
16
lame -h -b 192 "$x" "$y"
1104
17
rm "$x"
1105
18
rm "$i"
1106
19
done
Status:	Needs review
Proposed branch:	lp:~ubuntu-fr-scripts/ufrs-audio/audio-new
Merge into:	lp:ufrs-audio
Diff against target:	None lines
To merge this branch:	bzr merge lp:~ubuntu-fr-scripts/ufrs-audio/audio-new
Related bugs:	Link a bug report
Related blueprints:	Passage à la branche stable ufrs-audio (Essential)
Reviewer	Review Type	Date Requested	Status
Jean-Mi	passage branche principale		Approve on 2009-03-25
Etienne Gadeski	passage branche principale	2009-03-25	Pending
Review via email: mp+4874@code.launchpad.net