Skip to content
This repository has been archived by the owner on Jan 9, 2020. It is now read-only.

Commit

Permalink
Updating README file
Browse files Browse the repository at this point in the history
  • Loading branch information
Andre Miranda committed Jul 6, 2015
1 parent d2a5df0 commit 234508c
Show file tree
Hide file tree
Showing 2 changed files with 58 additions and 90 deletions.
112 changes: 22 additions & 90 deletions README.old → LICENSE-3RD-PARTY
Original file line number Diff line number Diff line change
@@ -1,72 +1,4 @@
_ _____ ____ ____ ____ _
| |/ /_ _/ ___/ ___| | _ \| | __ _ _ _ ___ _ __
| ' / | |\___ \___ \ | |_) | |/ _` | | | |/ _ \ '__|
| . \ | | ___) |__) | | __/| | (_| | |_| | __/ |
|_|\_\___|____/____/ |_| |_|\__,_|\__, |\___|_|
|___/

README

KISS Player is a simple and light music player with the KISS principle
in mind. Study the LICENSE file for distribution terms and usage conditions.

CONTACT

If you have problems, questions, ideas or suggestions, please contact me
andre_ldm_1989[at]g_mail[dot]com - Remove all underscores [_]

WEB SITE

Visit the KISS Player project web site for the latest news and downloads:
https://sourceforge.net/projects/kissplayer/

HOW TO USE

First you should have your songs on one or more directories.
Open KISS Player, click the menu button(with 3 lines) and select the option Settings.
Add your directory(ies) and close the settings window.
On main window menu select the option Synchronize Library.
Now you can play your songs which are avaliable on the left panel.

BUILDING

First take a look at https://sourceforge.net/p/kissplayer/wiki/Dependencies/
Once you have all the dependecies properly installed, you have two options:
1. Use the Code::Blocks IDE
2. Use the Makefiles:
2a. On Linux: make && make install
2b. On Windows(MinGW): mingw32-make && mingw32-make install

SETTING LANGUAGE

On Linux, check the activated locales with the command: locale -a
If you choose a language, for example pt_BR, it must be activated
otherwise use the command: locale-gen pt_BR.UTF-8

MERCURIAL

To download the very latest source off the MERCURIAL server do this:
hg clone http://hg.code.sf.net/p/kissplayer/code kissplayer-code

COPYRIGHT
KISS Player
Copyright (C) 2012-2014 by André Miranda

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

THIRD-PARTY ACKNOWLEDGEMENTS
THIRD-PARTY LICENSES

Product: FLTK
Copyright: 1998-2011 by Bill Spitzak
Expand All @@ -76,35 +8,35 @@ Notice: KISS Player is based in part on the work of the FLTK project (http://www
Product: FMOD Ex SoundSystem
Copyright: 2005-2013 Firelight Technologies Pty, Ltd.
License: FMOD NON-COMMERCIAL LICENSE
IF YOUR PRODUCT IS NOT INTENDED FOR COMMERCIAL GAIN AND DOES NOT
INCLUDE THE FMOD LIBRARY FOR RESALE, LICENSE OR OTHER COMMERCIAL
DISTRIBUTION, THEN USE OF FMOD IS FREE OF CHARGE. THERE ARE NO
IF YOUR PRODUCT IS NOT INTENDED FOR COMMERCIAL GAIN AND DOES NOT
INCLUDE THE FMOD LIBRARY FOR RESALE, LICENSE OR OTHER COMMERCIAL
DISTRIBUTION, THEN USE OF FMOD IS FREE OF CHARGE. THERE ARE NO
LICENSE FEES FOR NON-COMMERCIAL APPLICATIONS.

CONDITIONS/LIMITATIONS:
- WHEN USING THIS LICENSE, THE FMOD LIBRARY CANNOT BE USED FOR
RESALE OR OTHER COMMERCIAL DISTRIBUTION
- THIS LICENSE CANNOT BE USED FOR PRODUCTS WHICH DO NOT MAKE
PROFIT BUT ARE STILL COMMERCIALLY RELEASED
- THIS LICENSE CANNOT BE USED FOR COMMERCIAL SERVICES, WHERE THE
- WHEN USING THIS LICENSE, THE FMOD LIBRARY CANNOT BE USED FOR
RESALE OR OTHER COMMERCIAL DISTRIBUTION
- THIS LICENSE CANNOT BE USED FOR PRODUCTS WHICH DO NOT MAKE
PROFIT BUT ARE STILL COMMERCIALLY RELEASED
- THIS LICENSE CANNOT BE USED FOR COMMERCIAL SERVICES, WHERE THE
EXECUTABLE CONTAINING FMOD IS NOT SOLD, BUT THE DATA IS.
- WHEN USING FMOD, A CREDIT LINE IS REQUIRED IN EITHER DOCUMENTATION,
OR 'ON SCREEN' FORMAT (IF POSSIBLE). IT SHOULD CONTAIN AT LEAST
THE WORDS FMOD SOUND SYSTEM AND FIRELIGHT TECHNOLOGIES.
LOGOS ARE AVAILABLE FOR BOX OR MANUAL ART, BUT ARE NOT MANDANTORY.
- WHEN USING FMOD, A CREDIT LINE IS REQUIRED IN EITHER DOCUMENTATION,
OR 'ON SCREEN' FORMAT (IF POSSIBLE). IT SHOULD CONTAIN AT LEAST
THE WORDS FMOD SOUND SYSTEM AND FIRELIGHT TECHNOLOGIES.
LOGOS ARE AVAILABLE FOR BOX OR MANUAL ART, BUT ARE NOT MANDANTORY.

Product: TagLib
Copyright: 2002-2008, Scott Wheeler
License: LGPL-2.1
This library is free software; you can redistribute it and/or modify
it under the terms of the GNU Lesser General Public License version
2.1 as published by the Free Software Foundation.

This library is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
Expand All @@ -129,19 +61,19 @@ License: libpng License
assume no liability for direct, indirect, incidental, special, exemplary,
or consequential damages, which may result from the use of the PNG
Reference Library, even if advised of the possibility of such damage.

Permission is hereby granted to use, copy, modify, and distribute this
source code, or portions hereof, for any purpose, without fee, subject
to the following restrictions:

1. The origin of this source code must not be misrepresented.

2. Altered versions must be plainly marked as such and must not
be misrepresented as being the original source.

3. This Copyright notice may not be removed or altered from
any source or altered source distribution.

The Contributing Authors and Group 42, Inc. specifically permit, without
fee, and encourage the use of this source code as a component to
supporting the PNG file format in commercial products. If you use this
Expand Down Expand Up @@ -175,15 +107,15 @@ License: curl License
Permission to use, copy, modify, and distribute this software for any purpose
with or without fee is hereby granted, provided that the above copyright
notice and this permission notice appear in all copies.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. IN
NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE
OR OTHER DEALINGS IN THE SOFTWARE.

Except as contained in this notice, the name of a copyright holder shall not
be used in advertising or otherwise to promote the sale, use or other dealings
in this Software without prior written authorization of the copyright holder.
Expand Down
36 changes: 36 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,9 +9,45 @@

![kissplayer](https://cloud.githubusercontent.com/assets/599565/6767569/9a85cff8-d015-11e4-9574-1f1b7b7a9213.png)


Cross-platform and open-source Music Player designed to be simple and lightweight.
If you want a player full of features, most of them you don't use, exaggerated eye-candy and a memory hog, take a look around , there are lots. However if you want a different player that doesn't distract you or wastes your time, KISS Player can be a great alternative.

As of now, it's alpha, usable, but lacks some minor features and needs more polishing. Suggestions and contributions are welcome.

Note: The name has nothing to do with the metal band or the act of kissing. It's an acronym for "Keep it simple, stupid" principle.

#### Usage

- First you should have your songs on one or more directories.
- Open KISS Player, click the menu button(with 3 lines) and select the option Settings.
- Add your directory(ies) and close the settings window.
- On main window menu select the option Synchronize Library.
- Now you can play your songs which are available on the left panel.
- You can also drag and drop files on main window.

#### How to build

[Check the project's wiki for instructions](https://github.com/andreldm/kissplayer/wiki/Building%20from%20source)

#### Change the language
On Windows, there is an option for this under settings.<br/>
On Linux, check the current locale with the command: `locale`<br/>
Check [Arch's wiki](https://wiki.archlinux.org/index.php/Locale#Setting_the_locale) for instructions on how to manage locales.

#### Copyright
KISS Player
Copyright (C) 2012-2014 by André Miranda

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; version 2 of the License.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

0 comments on commit 234508c

Please sign in to comment.