153
142
window) or displayed by one or more windows.
156
How to display the buffers list on the left side?
157
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
145
=== How to display the buffers list on the left side?
159
147
Use script 'buffers.pl'.
161
149
To limit size of bar:
163
----------------------------------------
164
152
/set weechat.bar.buffers.size_max 15
165
----------------------------------------
167
155
To move bar to bottom:
169
----------------------------------------
170
158
/set weechat.bar.buffers.position bottom
171
----------------------------------------
173
161
[[customize_prefix]]
174
How can I reduce length of nicks or remove nick alignment in chat area?
175
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
162
=== How can I reduce length of nicks or remove nick alignment in chat area?
177
164
To reduce max length of nicks in chat area:
179
----------------------------------------
180
167
/set weechat.look.prefix_align_max 15
181
----------------------------------------
183
170
To remove nick alignment:
185
----------------------------------------
186
173
/set weechat.look.prefix_align none
187
----------------------------------------
189
176
[[input_bar_size]]
190
How to use command line with more than one line?
191
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
177
=== How to use command line with more than one line?
193
179
The option 'size' in input bar can be set to a value higher than 1 (for fixed
194
180
size, default size is 1) or 0 for dynamic size, and then option 'size_max' will
197
183
Example with dynamic size:
199
----------------------------------------
200
186
/set weechat.bar.input.size 0
201
----------------------------------------
205
----------------------------------------
206
192
/set weechat.bar.input.size_max 2
207
----------------------------------------
209
195
[[one_input_root_bar]]
210
Is it possible to display only one input bar for all windows (after split)?
211
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
196
=== Is it possible to display only one input bar for all windows (after split)?
213
198
Yes, you will have to create a bar with type "root" (with an item to know in
214
199
which window you are), then delete current input bar.
218
----------------------------------------
219
204
/bar add rootinput root bottom 1 0 [buffer_name]+[input_prompt]+(away),[input_search],[input_paste],input_text
221
----------------------------------------
223
208
If ever you are not satisfied with that, just delete new bar, WeeChat will
224
209
automatically create default bar "input" if item "input_text" is not used in
227
----------------------------------------
228
213
/bar del rootinput
229
----------------------------------------
231
216
[[terminal_copy_paste]]
232
How can I copy/paste text without pasting nicklist?
233
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
217
=== How can I copy/paste text without pasting nicklist?
235
219
You can use a terminal with rectangular selection (like rxvt-unicode,
236
konsole, gnome-terminal, ...). Key is usually @k(C-)@k(A-) mouse selection.
220
konsole, gnome-terminal, ...). Key is usually key[ctrl-]key[alt-] mouse
238
223
Another solution is to move nicklist to top or bottom, for example:
240
----------------------------------------
241
226
/set weechat.bar.nicklist.position top
242
----------------------------------------
245
How can I click on long URLs (more than one line)?
246
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
230
=== How can I click on long URLs (more than one line)?
248
232
By default, WeeChat displays time and prefix for each line and optional bars
249
233
around chat area. To make easier URL click, you can move nicklist to top and
250
234
remove alignment on nick:
252
----------------------------------------
253
237
/set weechat.bar.nicklist.position top
254
238
/set weechat.look.prefix_align none
255
239
/set weechat.look.align_end_of_lines time
256
----------------------------------------
258
242
With WeeChat ≥ 0.3.6, you can enable option "eat_newline_glitch", so that
259
243
new line char is not added at the end of each line displayed (it will not break
262
----------------------------------------
263
247
/set weechat.look.eat_newline_glitch on
264
----------------------------------------
267
251
This option may cause display bugs. If you experience such problem, you must
270
254
Other solution is to use a script: http://weechat.org/scripts/stable/tag/url
272
256
[[change_locale_without_quit]]
273
I want to change the language used by WeeChat for messages, but without exiting WeeChat, is it possible?
274
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
257
=== I want to change the language used by WeeChat for messages, but without exiting WeeChat, is it possible?
276
259
Yes, you have to use a python script, 'shell.py' (available on WeeChat website)
277
260
and issue these commands when script is loaded:
279
----------------------------------------
280
263
/shell setenv LANG=en_US.UTF-8
282
----------------------------------------
284
267
To have English messages with UTF-8 encoding for terminal, for ISO users, you
285
268
can issue: `/shell setenv LANG=en_US`.
287
270
[[use_256_colors]]
288
How can I use 256 colors in WeeChat?
289
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
271
=== How can I use 256 colors in WeeChat?
291
273
256 colors are supported with WeeChat ≥ 0.3.4.
303
285
If you are using screen, you can add this line to your '~/.screenrc':
305
----------------------------------------
306
288
term screen-256color
307
----------------------------------------
309
291
If your 'TERM' variable has wrong value and that WeeChat is already running,
310
292
don't panic! You can change it without restarting, thanks to script 'shell.py':
312
----------------------------------------
313
295
/shell setenv TERM=screen-256color
315
----------------------------------------
317
299
For version 0.3.4, you must use command `/color` to add new colors.
322
304
Please read user's guide for more information about colors management.
325
How can I search text in buffer (like /lastlog in irssi)?
326
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
307
=== How can I search text in buffer (like /lastlog in irssi)?
328
The default key is @k(C-)@k(r) (command is: `/input search_text`).
329
And jump to highlights: @k(A-)@k(p)/@k(n).
309
The default key is key[ctrl-r] (command is: `/input search_text`).
310
And jump to highlights: key[alt-p] / key[alt-n].
331
312
See user's guide for more info about this feature (default key bindings).
338
Some meta keys (alt + key) are not working, why?
339
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
318
=== Some meta keys (alt + key) are not working, why?
341
320
If you're using some terminals like xterm or uxterm, some meta keys does not
342
321
work by default. You can add a line in file '~/.Xresources':
345
----------------------------------------
346
325
XTerm*metaSendsEscape: true
347
----------------------------------------
349
----------------------------------------
350
329
UXTerm*metaSendsEscape: true
351
----------------------------------------
353
332
And then reload resources (`xrdb -override ~/.Xresources`) or restart X.
355
334
[[customize_key_bindings]]
356
How can I customize key bindings?
357
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
335
=== How can I customize key bindings?
359
337
Key bindings are customizable with `/key` command.
361
Default key @k(A-)@k(k) lets you grab key code and insert it in command line.
339
Default key key[alt-k] lets you grab key code and insert it in command line.
363
341
[[jump_to_buffer_11_or_higher]]
364
What is the key to jump to buffer 11 (or higher number)?
365
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
342
=== What is the key to jump to buffer 11 (or higher number)?
367
The key is @k(A-)@k(j) and then 2 digits, for example @k(A-)@k(j) then @k(1),
368
@k(1) to jump to buffer 11.
344
The key is key[alt-j] and then 2 digits, for example key[alt-j], key[1], key[1]
345
to jump to buffer 11.
370
347
You can bind a key, for example:
372
----------------------------------------
373
350
/key bind meta-q /buffer *11
374
----------------------------------------
376
353
List of default keys is in User's guide.
378
355
[[global_history]]
379
How to use global history (instead of buffer history) with up and down keys?
380
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
356
=== How to use global history (instead of buffer history) with up and down keys?
382
358
You can bind the up and down keys on global history (default keys for global
383
history are @k(C-)@k(↑) and @k(C-)@k(↓)).
359
history are key[ctrl-↑] and key[ctrl-↓]).
387
----------------------------------------
388
364
/key bind meta2-A /input history_global_previous
389
365
/key bind meta2-B /input history_global_next
390
----------------------------------------
393
369
Keys "meta2-A" and "meta2-B" may be different in your terminal. To find key
394
code press @k(A-)@k(k) then key (up or down).
370
code press key[alt-k] then key (up or down).
400
375
[[mouse_not_working]]
401
Mouse is not working at all, what can I do?
402
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
376
=== Mouse is not working at all, what can I do?
404
378
Mouse is supported with WeeChat ≥ 0.3.6.
406
380
First try to enable mouse:
408
----------------------------------------
410
----------------------------------------
412
386
If mouse is still not working, check the TERM variable in your shell (look at
413
387
output of `echo $TERM` in your terminal).
416
390
You can test mouse support in terminal:
418
----------------------------------------
419
393
$ printf '\033[?1002h'
420
----------------------------------------
422
396
And then click on first char of terminal (upper left). You should see " !!#!!".
424
398
To disable mouse in terminal:
426
----------------------------------------
427
401
$ printf '\033[?1002l'
428
----------------------------------------
431
Mouse does nothing for X or Y greater than 94, why?
432
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
405
=== Mouse does nothing for X or Y greater than 94 (or 222), why?
434
407
Some terminals are sending only ISO chars for mouse coordinates, so it does not
435
work for X/Y greater than 94.
408
work for X/Y greater than 94 (or 222).
437
410
You should use a terminal that supports UTF-8 coordinates for mouse, like
440
413
[[mouse_select_paste]]
441
How can I select or paste text in terminal when mouse is enabled in WeeChat?
442
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
414
=== How can I select or paste text in terminal when mouse is enabled in WeeChat?
444
When mouse is enabled in WeeChat, you can use @k(-S-) modifier to select or
416
When mouse is enabled in WeeChat, you can use key[shift] modifier to select or
445
417
click in terminal, as if the mouse was disabled (on some terminals like iTerm,
446
you have to use @k(-A-) instead of @k(-S-)).
418
you have to use key[alt] instead of key[shift]).
452
423
[[irc_ssl_connection]]
453
I have some problems when connecting to a server using SSL, what can I do?
454
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
424
=== I have some problems when connecting to a server using SSL, what can I do?
456
426
If you see errors about gnutls handshake, you can try to use a smaller
457
427
Diffie-Hellman key (default is 2048):
459
----------------------------------------
460
430
/set irc.server.freenode.ssl_dhkey_size 1024
461
----------------------------------------
463
433
If you see errors about certificate, you can disable "ssl_verify" (be careful,
464
434
connection will be less secure by doing that):
466
----------------------------------------
467
437
/set irc.server.freenode.ssl_verify off
468
----------------------------------------
470
440
[[irc_ssl_handshake_error]]
471
When connecting to server with SSL, I see only error "TLS handshake failed", what can I do?
472
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
441
=== When connecting to server with SSL, I see only error "TLS handshake failed", what can I do?
474
443
You can try a different priority string (WeeChat ≥ 0.3.5 only), replace "xxx"
475
444
by your server name:
477
----------------------------------------
478
447
/set irc.server.xxx.ssl_priorities "NORMAL:-VERS-TLS-ALL:+VERS-TLS1.0:+VERS-SSL3.0:%COMPAT"
479
----------------------------------------
481
450
[[irc_ssl_freenode]]
482
How can I connect to freenode server using SSL?
483
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
451
=== How can I connect to freenode server using SSL?
485
453
Set option 'weechat.network.gnutls_ca_file' to file with certificates:
487
----------------------------------------
488
456
/set weechat.network.gnutls_ca_file "/etc/ssl/certs/ca-certificates.crt"
489
----------------------------------------
492
460
Check that you have this file on your system (commonly brought by package
495
463
Setup server port, SSL, dhkey_size, then connect:
497
----------------------------------------
498
466
/set irc.server.freenode.addresses "chat.freenode.net/7000"
499
467
/set irc.server.freenode.ssl on
500
468
/set irc.server.freenode.ssl_dhkey_size 1024
501
469
/connect freenode
502
----------------------------------------
505
How to connect to a server that requires "oauth"?
506
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
473
=== How to connect to a server that requires "oauth"?
508
475
Some servers like 'twitch' require oauth to connect.
512
479
You can create such server and connect with following commands (replace name
513
480
and address by appropriate values):
515
----------------------------------------
516
483
/server add name irc.server.org -password="oauth:XXXX"
518
----------------------------------------
521
How can I be identified before joining channels?
522
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
488
=== How can I be identified before joining channels?
524
490
If server supports SASL, you should use that instead of sending command for
525
491
nickserv authentication, for example:
527
----------------------------------------
528
494
/set irc.server_default.sasl_mechanism dh-blowfish
529
495
/set irc.server.freenode.sasl_username "mynick"
530
496
/set irc.server.freenode.sasl_password "xxxxxxx"
531
----------------------------------------
533
499
If server does not support SASL, you can add a delay (between command and join
536
----------------------------------------
537
503
/set irc.server.freenode.command_delay 5
538
----------------------------------------
540
506
[[ignore_vs_filter]]
541
What is the difference between the /ignore and /filter commands?
542
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
507
=== What is the difference between the /ignore and /filter commands?
544
509
The `/ignore` command is an IRC command, so it applies only for IRC buffers
545
510
(servers and channels).
552
517
It lets you filter some lines in buffers with tags or regular expression for
553
518
prefix and content of line.
554
519
Filtered lines are only hidden, not deleted, and you can see them if you
555
disable filters (by default, the key @k(A-)@k(=) toggles filters).
520
disable filters (by default, the key key[alt-=] toggles filters).
557
522
[[filter_irc_join_part_quit]]
558
How can I filter join/part/quit messages on IRC channels?
559
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
523
=== How can I filter join/part/quit messages on IRC channels?
561
525
With smart filter (keep join/part/quit from users who spoke recently):
563
----------------------------------------
564
528
/set irc.look.smart_filter on
565
529
/filter add irc_smart * irc_smart_filter *
566
----------------------------------------
568
532
With a global filter (hide *all* join/part/quit):
570
----------------------------------------
571
535
/filter add joinquit * irc_join,irc_part,irc_quit *
572
----------------------------------------
575
539
For help: `/help filter` and `/help irc.look.smart_filter`
577
541
[[filter_irc_join_channel_messages]]
578
How can I filter some messages displayed when I join an IRC channel?
579
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
542
=== How can I filter some messages displayed when I join an IRC channel?
581
544
With WeeChat ≥ 0.4.1, you can disable some messages with option
582
545
'irc.look.display_join_message'.
584
547
For example, to disable names (which is IRC message '366'):
586
----------------------------------------
587
550
/set irc.look.display_join_message "329,332,333"
588
----------------------------------------
591
554
For help: `/help irc.look.display_join_message`
605
----------------------------------------
606
569
/filter add irc_join_names * irc_366 *
607
----------------------------------------
608
571
* filter topic (and date):
609
----------------------------------------
610
573
/filter add irc_join_topic_date * irc_332,irc_333 *
611
----------------------------------------
613
576
[[filter_voice_messages]]
614
How can I filter voice messages (eg on Bitlbee server)?
615
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
577
=== How can I filter voice messages (eg on Bitlbee server)?
617
579
It's not easy to filter voice messages, because voice mode can be set with other
618
580
modes in same IRC message.
624
586
For Bitlbee ≥ 3, do that on channel '&bitlbee':
626
----------------------------------------
627
589
channel set show_users online,away
628
----------------------------------------
630
592
For older version of Bitlbee, do that on channel '&bitlbee':
632
----------------------------------------
633
595
set away_devoice false
634
----------------------------------------
636
598
For checking away nicks in WeeChat, see question about
637
599
<<color_away_nicks,away nicks>>.
639
601
If you really want to filter voice messages, you can use this command, but this
640
602
is not perfect (will work only if first mode changed is voice):
642
----------------------------------------
643
605
/filter add hidevoices * irc_mode (\+|\-)v
644
----------------------------------------
646
608
[[color_away_nicks]]
647
How can I see away nicks in nicklist?
648
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
609
=== How can I see away nicks in nicklist?
650
611
You have to set option 'irc.server_default.away_check' to a positive value
651
612
(minutes between each check of away nicks).
656
617
For example, check every 5 minutes for away nicks, for channels with max 25
659
----------------------------------------
660
621
/set irc.server_default.away_check 5
661
622
/set irc.server_default.away_check_max_nicks 25
662
----------------------------------------
665
626
For WeeChat ≤ 0.3.3, options are 'irc.network.away_check' and
666
627
'irc.network.away_check_max_nicks'.
668
629
[[highlight_notification]]
669
How can I be warned when someone highlights me on a channel?
670
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
630
=== How can I be warned when someone highlights me on a channel?
672
632
You can use a script like 'beep.pl' or 'launcher.pl'.
674
634
For 'launcher.pl', you have to setup command:
676
----------------------------------------
677
637
/set plugins.var.perl.launcher.signal.weechat_highlight "/path/to/command arguments"
678
----------------------------------------
680
640
Other scripts on this subject: http://weechat.org/scripts/stable/tag/notify/
682
642
[[irc_target_buffer]]
683
How can I change target buffer for commands on merged buffers (like buffer with servers)?
684
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
643
=== How can I change target buffer for commands on merged buffers (like buffer with servers)?
686
The default key is @k(C-)@k(x) (command is: `/input switch_active_buffer`).
645
The default key is key[ctrl-x] (command is: `/input switch_active_buffer`).
688
647
[[plugins_scripts]]
692
650
[[openbsd_plugins]]
693
I'm using OpenBSD and WeeChat does not load any plugins, what's wrong?
694
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
651
=== I'm using OpenBSD and WeeChat does not load any plugins, what's wrong?
696
653
Under OpenBSD, plugin filenames end with ".so.0.0" (".so" for Linux).
698
655
You must set that up:
700
----------------------------------------
701
658
/set weechat.plugin.extension ".so.0.0"
703
----------------------------------------
706
How can I load Perl/Python/Ruby/Lua/Tcl scripts? Are scripts compatible with other IRC clients?
707
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
663
=== How can I load Perl/Python/Ruby/Lua/Tcl scripts? Are scripts compatible with other IRC clients?
709
665
You can use the commands `/perl`, `/python`, `/ruby`, `/lua` and `/tcl` to load
710
666
scripts (default path for scripts is '~/.weechat/<language>/').
739
693
* reduce value of option 'weechat.history.max_commands'
745
698
[[bug_task_patch]]
746
How should I report bugs, ask for new features or send patches?
747
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
699
=== How should I report bugs, ask for new features or send patches?
749
701
There are 3 ways:
751
703
. you can join us on IRC: 'irc.freenode.net', channel '#weechat'
752
. you can use the savannah website:
704
. you can use the Savannah website:
753
705
* report a bug: https://savannah.nongnu.org/bugs/?group=weechat
754
706
* request a new feature: https://savannah.nongnu.org/task/?group=weechat
755
707
* send a patch: https://savannah.nongnu.org/patch/?group=weechat
758
710
(you can subscribe and send to "support" mailing list)
760
712
[[gdb_error_threads]]
761
When I run WeeChat under gdb, there is error about threads, what can I do?
762
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
713
=== When I run WeeChat under gdb, there is error about threads, what can I do?
764
715
When you run WeeChat under gdb, you may have this error:
766
----------------------------------------
767
718
$ gdb /path/to/weechat
769
720
[Thread debugging using libthread_db enabled]
770
721
Cannot find new threads: generic error
771
----------------------------------------
773
724
To fix that, you can run gdb with this command (replace path to libpthread and
774
725
WeeChat with paths on your system):
776
----------------------------------------
777
728
$ LD_PRELOAD=/lib/libpthread.so.0 gdb /path/to/weechat
779
----------------------------------------
782
What is the list of supported platforms for WeeChat? Will it be ported to other operating systems?
783
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
733
=== What is the list of supported platforms for WeeChat? Will it be ported to other operating systems?
785
735
The full list is on this page: http://weechat.org/download
added
removed
doc/en/weechat_faq.en.txt
