Fix gi.require_version warning
[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 **Fork by Cyrille37**
14
15 :Author: Cyrille37 <cyrille37@gmail.com>
16
17 - Some changes to make indicator-chars works on Ubuntu 12.04LTS with Unity 2D
18
19   - replace the custom icon with a theme icon name
20
21   - add a char copy into Clipboard(selection="CLIPBOARD")
22
23 - Other minors changes
24
25   - use env to find the Python engine
26
27   - add a configuration file example: "conf-example.indicator-chars"
28
29 **Fork by Adrian I Lam**
30
31 :Author: Adrian I Lam <adrianiainlam@gmail.com>
32
33 - Changes to Cyrille37's fork:
34
35   - port to Python 3 from Python 2
36
37   - use the svg custom icon
38
39 -------
40 Install
41 -------
42
43 - Checkout source code
44
45 - Create ~/.indicator-chars
46
47   - Each row corresponds to a set of chars
48
49   - Optional submenu title prefix: "[title]" (trailing spaces stripped)
50
51   - Optional descriptions after chars: "(description)" (leading &
52     trailing spaces stripped)
53
54   - Spaces (apart from above) also count as chars
55
56   - Make sure to use UTF-8 encoding
57
58 - Put indicator-chars.py into auto start
59
60 -----------
61 Open issues
62 -----------
63
64 - If anyone could design a nice, unity style indicator icon?
65
66 - Maybe there is a way to use multiple click buttons in menu items?
67
68   - No standard Gtk way does not work.