Merge branch 'master' of https://github.com/Cyrille37/indicator-chars
[indicator-chars.git] / README.rst
1 ===============
2 indicator-chars
3 ===============
4
5 :Author: Tobias Schlitt <toby@php.net>
6
7 App indicator to provide a menu with (potentially funny UTF-8) characters for
8 simple copying them to clipboard (similar to original characters applet).
9
10 Create a file .indicator-chars in your home directory with lines of
11 characters to be selectable.
12
13 -------
14 Fork Cyrille37
15 -------
16
17 :Author: Cyrille37 <cyrille37@gmail.com>
18
19 - Some changes to make indicator-chars works on Ubuntu 12.04LTS with Unity 2D
20
21   - replace the custom icon with a theme icon name
22
23   - add a char copy into Clipboard(selection="CLIPBOARD")
24
25 - Other minors changes
26
27   - use env to find the Python engine
28
29   - add a configuration file example: "conf-example.indicator-chars"
30
31 -------
32 Install
33 -------
34
35 - Checkout source code
36
37 - Create ~/.indicator-chars
38
39   - Each row corresponds to a set of chars
40
41   - Optional submenu title prefix: "[title]" (trailing spaces stripped)
42
43   - Optional descriptions after chars: "(description)" (leading &
44     trailing spaces stripped)
45
46   - Spaces (apart from above) also count as chars
47
48   - Make sure to use UTF-8 encoding
49
50 - Put indicator-chars.py into auto start
51
52 -----------
53 Open issues
54 -----------
55
56 - If anyone could design a nice, unity style indicator icon?
57
58 - Maybe there is a way to use multiple click buttons in menu items?
59
60   - No standard Gtk way does not work.