~kokoto-java/kazam/depencie-and-stuff

« back to all changes in this revision

Viewing changes to README

  • Committer: David Klasinc
  • Date: 2012-10-30 10:35:36 UTC
  • mto: (193.7.2 unstable)
  • mto: This revision was merged to the branch mainline in revision 196.
  • Revision ID: bigwhale@lubica.net-20121030103536-fpdlumzgxtlli2nt
Readme & co. changes.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
 
2
 
           Kazam Screencaster v1.4.0 "NCC-74656"
 
2
           Kazam Screencaster v1.3.1 "NCC-2893"
3
3
 
4
4
 
5
5
Introduction
18
18
 
19
19
Kazam is always available from Launchpad under https://launchpad.net/kazam
20
20
 
21
 
Right now there are only unstable versions available, the project is still
22
 
in development and a stable release is planned for Ubuntu 12.04.
23
 
 
24
 
 
25
 
Installation
26
 
------------
27
 
 
28
 
If you are using Ubuntu 12.04 - Precise Pangolin then stable version (1.0.x)
 
21
Latest stable release is 1.0.6.
 
22
Latest unstable release is 1.3.1 - Stargazer edition
 
23
 
 
24
 
 
25
Installation - stable release
 
26
-----------------------------
 
27
 
 
28
If you are using Ubuntu 12.04 or 12.10 then stable version (1.0.x)
29
29
is available from universe repository. You can find it in Ubuntu Softare
30
30
Center or install it from the terminal with the following command:
31
31
 
41
41
For distribution independent installation you will have to get the latest
42
42
tarball release from Launchpad:
43
43
 
44
 
http://launchpad.net/kazam/stable/1.4.0/+download/kazam_1.4.0.tar.gz
 
44
http://launchpad.net/kazam/stable/1.0.6/+download/kazam_1.0.6.tar.gz
45
45
 
46
46
Unpack it and then run setup:
47
47
 
48
 
   $ tar -xzf kazam_1.4.0.tar.gz
49
 
   $ cd kazam-1.4.0
 
48
   $ tar -xzf kazam_1.0.6.tar.gz
 
49
   $ cd kazam-1.0.6
50
50
 
51
51
Run installation as root user, or use sudo:
52
52
 
53
53
   # python setup.py install
54
54
 
55
55
 
 
56
Installation - development version
 
57
----------------------------------
 
58
 
56
59
If you want bleeding edge, development version then you will have to get
57
60
source code from Launchpad by running the following command:
58
61
 
71
74
-------------
72
75
 
73
76
If you want to run Kazam from the source tree, there are a few limitations
74
 
that you have take into account. Right now Ubuntu App indicator will not
 
77
that you have to take into account. Right now Ubuntu App indicator will not
75
78
allow setting custom icons. Every icon has to be taken from currently
76
79
installed icon theme. See https://bugs.launchpad.net/kazam/+bug/657857 for
77
80
more information.
96
99
SUPER-CTRL-R - Start Recording
97
100
SUPER-CTRL-F - Finish Recording
98
101
 
 
102
Keyboard shortcuts will work if you installed Kazam 1.3.1 from a PPA,
 
103
keybinder 3.0 is now a dependency and will be installed automatically.
 
104
 
 
105
 
99
106
Known Issues
100
107
------------
101
108
 
106
113
- Placing Region selector outside of screen borders will produce unknown
107
114
results and you will probably end up with no video.
108
115
 
109
 
- Two warnings appear during the normal usage:
110
 
 
111
 
/usr/lib/python2.7/dist-packages/gobject/constants.py:24: Warning:
112
 
g_boxed_type_register_static: assertion `g_type_from_name (name) == 0' failed
113
 
 
114
 
This happens when Gtk.GObject was imported before importing gst in python
115
 
and is still being investigated. So far it appears to be mostly harmless.
116
 
 
117
 
Second warning comes from Gtk.FileChooser():
118
 
 
119
 
kazam:5144): Gtk-WARNING **: Unable to retrieve the file info for <file>
120
 
Error stating file <file> : No such file or directory
121
 
 
122
 
This happens when you confirm file save in the dialog box. This is an error
123
 
in Gtk.FileChooser and in Precise Pangolin it is fixed.
124
 
 
125
116
- Trouble with recording from certain Monitor sources. I noticed this with
126
117
Logitech G110 USB Keyboard that can play audio. Pulse Audio will see two
127
118
devices: USP PnP Stereo Device and Monitor of USB PnP Stereo Device. When
128
119
recording from the monitor, volume controls for both devices will affect
129
120
the volume in the final recording.
130
121
 
131
 
- I have no idea where to put Mute/Unmute button, so you'll have to check
132
 
that in pavucontrol or sound settings. :)
 
122
- I have no idea where to put Mute/Unmute button, so right now every audio
 
123
source you select is automatically unmuted.
133
124
 
134
125
- It was reported that sound is disappearing after couple of minutes into
135
126
the recording. I wasn't able to reproduce this bug and any more info is
139
130
Recording Tips
140
131
--------------
141
132
 
142
 
Framerates above 20fps are unlikely to work because of software and hardware
143
 
limitations. If you increase framerate and framerate in resulting video
144
 
drops, that is because encoder can't keep up with the framerate.
 
133
Framerates above 20fps are unlikely to work well because of software and
 
134
hardware limitations. If you increase framerate and framerate in
 
135
resulting video drops, that is because encoder can't keep up.
145
136
 
146
137
Always do a sound check. Especially if you are recording a live commentary
147
138
with background sound. I got the best results when I used earphones to listen
155
146
If you encounter a bug or any kind of unexpected behavior please try to
156
147
reproduce it while you run Kazam from standard terminal with --debug option.
157
148
Use Launchpad to report bugs (https://bugs.launchpad.net/kazam/+filebug) and
158
 
include generated output. It will also be helpful if you can attach generated
159
 
'dot' file. You will find this file in /tmp/kazam_debug.dot.
160
 
 
161
 
If you have graphviz package installed there is also /tmp/kazam_pipeline.png
162
 
file and you can inspect GStreamer pipeline if everything checks out ok.
 
149
include generated output.
163
150