
 gSmile - emoticon manager
 
 Copyright (C) 2005, Federico Pelloni <federico.pelloni@gmail.com>


 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 Library 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., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.


== gSmile ==

gSmile open-source emoticon manager
Version: 0.1.0

Written by Federico Pelloni <federico.pelloni@gmail.com>

Website: http://gsmile.sourceforge.net/
Project page: http://sourceforge.net/projects/gsmile/


== What is ==

gSmile is an open-source emoticon manager, with which you can store your
emoticons and find them quickly whenever you need one of them.

You can organize your emoticons in many folders (also nested) and,
with drag'n'drop, you can easily and quickly insert the right tag
(with the emoticon url) in your web-browser. It could sound difficult
or strange, but it is very simple and smart.

For example, if you need the emoticon `smile.gif`, whose URL is
`http://www.site.com/emoticons/smile.gif`, and you have stored it
into the `Happy` folder in gSmile, then you will only need to select
the `Happy` folder, drag the emoticon you want and drop it on the 
right field in the web-browser. gSmile will insert for you 
`[img]http://www.site.com/emoticons/smile.gif[/img]`.
You can of course change the tag from `[img][/img]` to whatever you
want.


== Requirements ==

- Linux operative system
- X window server
- GTK+ toolkit, version 2.6 or higher
- Python 2.3 or higher
- PyGTK 2.5 or higher (Python GTK wrapper)


== Supported OSes ==

At first, and while in heavy development, gSmile will be developed,
tested and supported to run on a Linux system.
Compatibly with gSmile and dependencies compatibility a MS Windows
version will be released.


== Features ==

- Emoticon drag-n-drop from and to the browser
- Customizable window appearence and behaviour
- Emoticons folders inside folders, with infinite depth
- Folder and emoticons reordering
- Most used, recent, ... emoticons Top10s
- Search function
- Multiple tagmode function: possibility of selection between many tags
							 to insert into browser form
- Emoticons-sets importing: capabilty of importing prebuilt sets of 
							emoticons


== File Formats ==

- Emoticons database will be an XML file (if needed, with an ad-hoc DTD)
- Emoticons will be stored "as they are", so .gif, .jpg, .png
- Emoticons-sets would probably be a .zip (or .tar.bz2) file containing
  XML and image files


== Interoperation capabilities ==

The user will be able to drag-n-drop emoticons between gSmile and the
largest number of webbrowsers it would be possible. Also drag-n-drop
from/to text-editors is possible (compatibly with GTK+ capabilities).


== Network ==

gSmile ability to get emoticons from the web depends on the capabilities
of Python libraries and GTK+/PyGTK libraries.


(NOTE: this is the description submitted to Sourceforge.net staff for
       the project approval. Some information in this text could not be
       be accurate. I'm sorry, but I haven't the will to rewrite this...)
