Difference between revisions of "Fbterm"

From Fcitx
Jump to navigation Jump to search
(Marked this version for translation)
m (Text replacement - "<translate1>" to "<translate>")
 
(12 intermediate revisions by the same user not shown)
Line 1: Line 1:
<languages />
+
<languages/>
  
 
<translate>
 
<translate>
Line 7: Line 7:
 
|screenshot            = [[File:fcitx-fbterm.png|200px]]
 
|screenshot            = [[File:fcitx-fbterm.png|200px]]
 
|caption2              = fbterm support for fcitx
 
|caption2              = fbterm support for fcitx
|version              = 0.1.3
+
|version              = 0.2.0
 
|programming language  = C
 
|programming language  = C
 
|dependency            = fbterm
 
|dependency            = fbterm
Line 16: Line 16:
 
== Intro == <!--T:2-->
 
== Intro == <!--T:2-->
 
Let you use fcitx under [http://code.google.com/p/fbterm/ fbterm].
 
Let you use fcitx under [http://code.google.com/p/fbterm/ fbterm].
 +
 +
This wiki page is written for fcitx-fbterm 0.2.0 or higher.
  
 
== Prepare == <!--T:3-->
 
== Prepare == <!--T:3-->
Make fbterm can use input method.
+
In order to make fbterm can use input method.
  
 
  <!--T:4-->
 
  <!--T:4-->
sudo setcap 'cap_sys_tty_config+ep' /usr/bin/fbterm
+
sudo setcap 'cap_sys_tty_config+ep' /usr/bin/fbterm # required to let fbterm get key-sequence
 +
 
 +
<!--T:17-->
 +
And add your account to video group with (use ls -l /dev/fb0 to check the user group):
 +
 
 +
<!--T:18-->
 +
sudo gpasswd -a <your username> video
  
 
<!--T:5-->
 
<!--T:5-->
or
+
or (it's NOT safe because it sets setuid.)
  
 
  <!--T:6-->
 
  <!--T:6-->
 
sudo chmod u+s /usr/bin/fbterm
 
sudo chmod u+s /usr/bin/fbterm
  
== Launch fbterm == <!--T:7-->
+
<!--T:7-->
 
Notice, if you don't use KMS (Kernel mode settings, in other words, open source display driver), you must start fbterm with root.
 
Notice, if you don't use KMS (Kernel mode settings, in other words, open source display driver), you must start fbterm with root.
  
=== With X running, and run as same user with X === <!--T:15-->
+
=== When fcitx is already running under X === <!--T:15-->
For example, if your X is :0 (by default, if you only have one X server).
+
For example, if your X is :0 (this is the default case for desktop user).
  
<!--T:8-->
+
You can use
export DISPLAY=:0
+
 
 +
<!--T:8-->
 
  fcitx-fbterm-helper
 
  fcitx-fbterm-helper
 +
 +
To start fbterm. If your display is not 0, for example, it's running as :1, you can use
 +
 +
fcitx-fbterm-helper -d 1
 +
 +
to override it.
  
 
<!--T:9-->
 
<!--T:9-->
If no error output, it will work.
+
If there is no error, then everything should work, one additional thing you need pay attention is, fbterm hardcodes Ctrl+Space as input method trigger key, this is not controlled by fcitx and not changable.
  
=== Without X or have problem === <!--T:10-->
+
=== Without X or have some problem === <!--T:10-->
 
  fcitx-fbterm-helper -l
 
  fcitx-fbterm-helper -l
  
 
<!--T:11-->
 
<!--T:11-->
It will launch a new dbus daemon and new fcitx. There is a message indicating that there should be only fcitx running. So run
+
It will launch new fcitx. And fcitx will be killed when fbterm ends.
  
<!--T:12-->
+
If there is already a fcitx running, fcitx-fbterm-helper will refuse to work, you can use
killall fcitx
 
  
<!--T:13-->
+
killall fcitx
before you start execute fcitx-fbterm-helper.
 
  
<!--T:14-->
+
to kill existing fcitx.
Unreleased fcitx-fbterm 0.1.4's fcitx-fbterm-helper can kill dbus-daemon and fcitx when fbterm quits, you can grab the script [https://github.com/fcitx/fcitx-fbterm/blob/master/scripts/fcitx-fbterm-helper here]. It's ok to run it from anywhere so you don't need to replace the system script.
 
  
== Trouble == <!--T:16-->
+
== Troubleshoot == <!--T:16-->
 
If you meet some trouble about keyboard not reaction, screen artifacts, you can first try Ctrl+Alt+E (force fbterm to exit), if this doesn't work and you have enabled magic key (sysctl, kernel.sysrq = 1), you can try only sysrq + r (not the full reisub!), this will force keyboard input to forward to kernel, then you can switch between tty.
 
If you meet some trouble about keyboard not reaction, screen artifacts, you can first try Ctrl+Alt+E (force fbterm to exit), if this doesn't work and you have enabled magic key (sysctl, kernel.sysrq = 1), you can try only sysrq + r (not the full reisub!), this will force keyboard input to forward to kernel, then you can switch between tty.
  
 
</translate>
 
</translate>

Latest revision as of 22:54, 2 February 2016


fcitx-fbterm
Fcitx-fbterm.png
Version 0.2.0
Dependency fbterm
Written In C
License GPLv2
Website http://github.com/fcitx/fcitx-fbterm

Intro

Let you use fcitx under fbterm.

This wiki page is written for fcitx-fbterm 0.2.0 or higher.

Prepare

In order to make fbterm can use input method.

sudo setcap 'cap_sys_tty_config+ep' /usr/bin/fbterm # required to let fbterm get key-sequence

And add your account to video group with (use ls -l /dev/fb0 to check the user group):

sudo gpasswd -a <your username> video

or (it's NOT safe because it sets setuid.)

sudo chmod u+s /usr/bin/fbterm

Notice, if you don't use KMS (Kernel mode settings, in other words, open source display driver), you must start fbterm with root.

When fcitx is already running under X

For example, if your X is :0 (this is the default case for desktop user).

You can use

fcitx-fbterm-helper

To start fbterm. If your display is not 0, for example, it's running as :1, you can use

fcitx-fbterm-helper -d 1

to override it.

If there is no error, then everything should work, one additional thing you need pay attention is, fbterm hardcodes Ctrl+Space as input method trigger key, this is not controlled by fcitx and not changable.

Without X or have some problem

fcitx-fbterm-helper -l

It will launch new fcitx. And fcitx will be killed when fbterm ends.

If there is already a fcitx running, fcitx-fbterm-helper will refuse to work, you can use

killall fcitx

to kill existing fcitx.

Troubleshoot

If you meet some trouble about keyboard not reaction, screen artifacts, you can first try Ctrl+Alt+E (force fbterm to exit), if this doesn't work and you have enabled magic key (sysctl, kernel.sysrq = 1), you can try only sysrq + r (not the full reisub!), this will force keyboard input to forward to kernel, then you can switch between tty.