1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
1660
1661
1662
1663
1664
1665
1666
1667
1668
1669
1670
1671
1672
1673
1674
1675
1676
1677
1678
1679
1680
1681
1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
1703
1704
1705
1706
1707
1708
1709
1710
1711
1712
1713
1714
1715
1716
1717
1718
1719
1720
1721
1722
1723
1724
1725
1726
1727
1728
1729
1730
1731
1732
1733
1734
1735
1736
1737
1738
1739
1740
1741
1742
1743
1744
1745
1746
1747
1748
1749
1750
1751
1752
1753
1754
1755
1756
1757
1758
1759
1760
1761
1762
1763
1764
1765
1766
1767
1768
1769
1770
1771
1772
1773
1774
1775
1776
1777
1778
1779
1780
1781
1782
1783
1784
1785
1786
1787
1788
1789
1790
1791
1792
1793
1794
1795
1796
1797
1798
1799
1800
1801
1802
1803
1804
1805
1806
1807
1808
1809
1810
1811
1812
1813
1814
1815
1816
1817
1818
1819
1820
1821
1822
1823
1824
1825
1826
1827
1828
1829
1830
1831
1832
1833
1834
1835
1836
1837
1838
1839
1840
1841
1842
1843
1844
1845
1846
1847
1848
1849
1850
1851
1852
1853
1854
1855
1856
1857
1858
1859
1860
1861
1862
1863
1864
1865
1866
1867
1868
1869
1870
1871
1872
1873
1874
1875
1876
1877
1878
1879
1880
1881
1882
1883
1884
1885
1886
1887
1888
1889
1890
1891
1892
1893
1894
1895
1896
1897
1898
1899
1900
1901
1902
1903
1904
1905
1906
1907
1908
1909
1910
1911
1912
1913
1914
1915
1916
1917
1918
1919
1920
1921
1922
1923
1924
1925
1926
1927
1928
1929
1930
1931
1932
1933
1934
1935
1936
1937
1938
1939
1940
1941
1942
1943
1944
1945
1946
1947
1948
1949
1950
1951
1952
1953
1954
1955
1956
1957
1958
1959
1960
1961
1962
1963
1964
1965
1966
1967
1968
1969
1970
1971
1972
1973
1974
1975
1976
1977
1978
1979
1980
1981
1982
1983
1984
1985
1986
1987
1988
1989
1990
1991
1992
1993
1994
1995
1996
1997
1998
1999
2000
2001
2002
2003
2004
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
2027
2028
2029
2030
2031
2032
2033
2034
2035
2036
2037
2038
2039
2040
2041
2042
2043
2044
2045
2046
2047
2048
2049
2050
2051
2052
2053
2054
2055
2056
2057
2058
2059
2060
2061
2062
2063
2064
2065
2066
2067
2068
2069
2070
2071
2072
2073
2074
2075
2076
2077
2078
2079
2080
2081
2082
2083
2084
2085
2086
2087
2088
2089
2090
2091
2092
2093
2094
2095
2096
2097
2098
2099
2100
2101
2102
2103
2104
2105
2106
2107
2108
2109
2110
2111
2112
2113
2114
2115
2116
2117
2118
2119
2120
2121
2122
2123
2124
2125
2126
2127
2128
2129
2130
2131
2132
2133
2134
2135
2136
2137
2138
2139
2140
2141
2142
2143
2144
2145
2146
2147
2148
2149
2150
2151
2152
2153
2154
2155
2156
2157
2158
2159
2160
2161
2162
2163
2164
2165
2166
2167
2168
2169
2170
2171
2172
2173
2174
2175
2176
2177
2178
2179
2180
2181
2182
2183
2184
2185
2186
2187
2188
2189
2190
2191
2192
2193
2194
2195
2196
2197
2198
2199
2200
2201
2202
2203
2204
2205
2206
2207
2208
2209
2210
2211
2212
2213
2214
2215
2216
2217
2218
2219
2220
2221
2222
2223
2224
2225
2226
2227
2228
2229
2230
2231
2232
2233
2234
2235
2236
2237
2238
2239
2240
2241
2242
2243
2244
2245
2246
2247
2248
2249
2250
2251
2252
2253
2254
2255
2256
2257
2258
2259
2260
2261
2262
2263
2264
2265
2266
2267
2268
2269
2270
2271
2272
2273
2274
2275
2276
2277
2278
2279
2280
2281
2282
2283
2284
2285
2286
2287
2288
2289
2290
2291
2292
2293
2294
2295
2296
2297
2298
2299
2300
2301
2302
2303
2304
2305
2306
2307
2308
2309
2310
2311
2312
2313
2314
2315
2316
2317
2318
2319
2320
2321
2322
2323
2324
2325
2326
2327
2328
2329
2330
2331
2332
2333
2334
2335
2336
2337
2338
2339
2340
2341
2342
2343
2344
2345
2346
2347
2348
2349
2350
2351
2352
2353
2354
2355
2356
2357
2358
2359
2360
2361
2362
2363
2364
2365
2366
2367
2368
2369
2370
2371
2372
2373
2374
2375
2376
2377
2378
2379
2380
2381
2382
2383
2384
2385
2386
2387
2388
2389
2390
2391
2392
2393
2394
2395
2396
2397
2398
2399
2400
2401
2402
2403
2404
2405
2406
2407
2408
2409
2410
2411
2412
2413
2414
2415
2416
2417
2418
2419
2420
2421
2422
2423
2424
2425
2426
2427
2428
2429
2430
2431
2432
2433
2434
2435
2436
2437
2438
2439
2440
2441
2442
2443
2444
2445
2446
2447
2448
2449
2450
2451
2452
2453
2454
2455
2456
2457
2458
2459
2460
2461
2462
2463
2464
2465
2466
2467
2468
2469
2470
2471
2472
2473
2474
2475
2476
2477
2478
2479
2480
2481
2482
2483
2484
2485
2486
2487
2488
2489
2490
2491
2492
2493
2494
2495
2496
2497
2498
2499
2500
2501
2502
2503
2504
2505
2506
2507
2508
2509
2510
2511
2512
2513
2514
2515
2516
2517
2518
2519
2520
2521
2522
2523
2524
2525
2526
2527
2528
2529
2530
2531
2532
2533
2534
2535
2536
2537
2538
2539
2540
2541
2542
2543
2544
2545
2546
2547
2548
2549
2550
2551
2552
2553
2554
2555
2556
2557
2558
2559
2560
2561
2562
2563
2564
2565
2566
2567
2568
2569
2570
2571
2572
2573
2574
2575
2576
2577
2578
2579
2580
2581
2582
2583
2584
2585
2586
2587
2588
2589
2590
2591
2592
2593
2594
2595
2596
2597
2598
2599
2600
2601
2602
2603
2604
2605
2606
2607
2608
2609
2610
2611
2612
2613
2614
2615
2616
2617
2618
2619
2620
2621
2622
2623
2624
2625
2626
2627
2628
2629
2630
2631
2632
2633
2634
2635
2636
2637
2638
2639
2640
2641
2642
2643
2644
2645
2646
2647
2648
2649
2650
2651
2652
2653
2654
2655
2656
2657
2658
2659
2660
2661
2662
2663
2664
2665
2666
2667
2668
2669
2670
2671
2672
2673
2674
2675
2676
2677
2678
2679
2680
2681
2682
2683
2684
2685
2686
2687
2688
2689
2690
2691
2692
2693
2694
2695
2696
2697
2698
2699
2700
2701
2702
2703
2704
2705
2706
2707
2708
2709
2710
2711
2712
2713
2714
2715
2716
2717
2718
2719
2720
2721
2722
2723
2724
2725
2726
2727
2728
2729
2730
2731
2732
2733
2734
2735
2736
2737
2738
2739
2740
2741
2742
2743
2744
2745
2746
2747
2748
2749
2750
2751
2752
2753
2754
2755
2756
2757
2758
2759
2760
2761
2762
2763
2764
2765
2766
2767
2768
2769
2770
2771
2772
2773
2774
2775
2776
2777
2778
2779
2780
2781
2782
2783
2784
2785
2786
2787
2788
2789
2790
2791
2792
2793
2794
2795
2796
2797
2798
2799
2800
2801
2802
2803
2804
2805
2806
2807
2808
2809
2810
2811
2812
2813
2814
2815
2816
2817
2818
2819
2820
2821
2822
2823
2824
2825
2826
2827
2828
2829
2830
2831
2832
2833
2834
2835
2836
2837
2838
2839
2840
2841
2842
2843
2844
2845
2846
2847
2848
2849
2850
2851
2852
2853
2854
2855
2856
2857
2858
2859
2860
2861
2862
2863
2864
2865
2866
2867
2868
2869
2870
2871
2872
2873
2874
2875
2876
2877
2878
2879
2880
2881
2882
2883
2884
2885
2886
2887
2888
2889
2890
2891
2892
2893
2894
2895
2896
2897
2898
2899
2900
2901
2902
2903
2904
2905
2906
2907
2908
2909
2910
2911
2912
2913
2914
2915
2916
2917
2918
2919
2920
2921
2922
2923
2924
2925
2926
2927
2928
2929
2930
2931
2932
2933
2934
2935
2936
2937
2938
2939
2940
2941
2942
2943
2944
2945
2946
2947
2948
2949
2950
2951
2952
2953
2954
2955
2956
2957
2958
2959
2960
2961
2962
2963
2964
2965
2966
2967
2968
2969
2970
2971
2972
2973
2974
2975
2976
2977
2978
2979
2980
2981
2982
2983
2984
2985
2986
2987
2988
2989
2990
2991
2992
2993
2994
2995
2996
2997
2998
2999
3000
3001
3002
3003
3004
3005
3006
3007
3008
3009
3010
3011
3012
3013
3014
3015
3016
3017
3018
3019
3020
3021
3022
3023
3024
3025
3026
3027
3028
3029
3030
3031
3032
3033
3034
3035
3036
3037
3038
3039
3040
3041
3042
3043
3044
3045
3046
3047
3048
3049
3050
3051
3052
3053
3054
3055
3056
3057
3058
3059
3060
3061
3062
3063
3064
3065
3066
3067
3068
|
//
// This file is auto-generated by script docgen.py.
// DO NOT EDIT BY HAND!
//
// tag::irc_commands[]
[[command_irc_admin]]
* `+admin+`: trouver les informations sur l'administrateur du serveur
----
/admin [<cible>]
cible : nom du serveur
----
[[command_irc_allchan]]
* `+allchan+`: exécuter une commande sur tous les canaux de tous les serveurs connectés
----
/allchan [-current] [-parted] [-exclude=<canal>[,<canal>...]] <commande>
[-current] [-parted] -include=<canal>[,<canal>...] <commande>
-current : exécuter la commande pour les canaux du serveur courant seulement
-parted : exécuter la commande sur les canaux quittés seulement
-exclude : exclure certains canaux (le caractère joker "*" est autorisé)
-include : inclure seulement certains canaux (le caractère joker "*" est autorisé)
commande : commande à exécuter (ou texte à envoyer au tampon si la commande ne commence pas par '/')
La commande et les paramètres sont évalués (voir /help eval), les variables suivantes sont remplacées :
$server nom du serveur
$channel nom du canal
$nick pseudo sur le serveur
${irc_server.xxx} variable xxx dans le serveur
${irc_channel.xxx} variable xxx dans le canal
Exemples :
exécuter '/me teste' sur tous les canaux :
/allchan /me teste
dire 'bonjour' partout sauf sur #weechat :
/allchan -exclude=#weechat bonjour
dire 'bonjour' partout sauf sur #weechat et les canaux commençant par #linux :
/allchan -exclude=#weechat,#linux* bonjour
dire 'bonjour' sur tous les canaux commençant par #linux :
/allchan -include=#linux* bonjour
fermer tous les tampons avec des canaux quittés :
/allchan -parted /close
----
[[command_irc_allpv]]
* `+allpv+`: exécuter une commande sur tous les tampons privés de tous les serveurs connectés
----
/allpv [-current] [-exclude=<pseudo>[,<pseudo>...]] <commande>
[-current] [-include=<pseudo>[,<pseudo>...]] <commande>
-current : exécuter la commande pour les tampons privés du serveur courant seulement
-exclude : exclure certains pseudos (le caractère joker "*" est autorisé)
-include : inclure seulement certains pseudos (le caractère joker "*" est autorisé)
commande : commande à exécuter (ou texte à envoyer au tampon si la commande ne commence pas par '/')
La commande et les paramètres sont évalués (voir /help eval), les variables suivantes sont remplacées :
$server nom du serveur
$channel nom du canal
$nick pseudo sur le serveur
${irc_server.xxx} variable xxx dans le serveur
${irc_channel.xxx} variable xxx dans le canal
Exemples :
exécuter '/me teste' sur tous les tampons privés :
/allpv /me teste
dire 'bonjour' partout sauf sur pour le pseudo foo :
/allpv -exclude=foo bonjour
dire 'bonjour' partout sauf pour le pseudo foo et les pseudos commençant par bar :
/allpv -exclude=foo,bar* bonjour
dire 'bonjour' pour tous les pseudos commençant par bar :
/allpv -include=bar* bonjour
fermer tous les tampons privés :
/allpv /close
----
[[command_irc_allserv]]
* `+allserv+`: exécuter une commande sur tous les serveurs connectés
----
/allserv [-exclude=<serveur>[,<serveur>...]] <commande>
[-include=<serveur>[,<serveur>...]] <commande>
-exclude : exclure certains serveurs (le caractère joker "*" est autorisé)
-include : inclure seulement certains serveurs (le caractère joker "*" est autorisé)
commande : commande à exécuter (ou texte à envoyer au tampon si la commande ne commence pas par '/')
La commande et les paramètres sont évalués (voir /help eval), les variables suivantes sont remplacées :
$server nom du serveur
$nick pseudo sur le serveur
${irc_server.xxx} variable xxx dans le serveur
Exemples :
changer de pseudo sur tous les serveurs :
/allserv /nick newnick
positionner l'absence sur tous les serveurs :
/allserv /away Je suis absent
faire un whois sur mon pseudo sur tous les serveurs :
/allserv /whois $nick
----
[[command_irc_auth]]
* `+auth+`: s'authentifier avec SASL
----
/auth [<utilisateur> <mot_de_passe>]
utilisateur : nom d'utilisateur SASL (le contenu est évalué, voir /help eval ; les options de serveur sont évaluées avec ${irc_server.xxx} et ${server} est remplacé par le nom du serveur)
mot_de_passe : mot de passe SASL ou chemin vers le fichier de clé privée (le contenu est évalué, voir /help eval ; les options de serveur sont évaluées avec ${irc_server.xxx} et ${server} est remplacé par le nom du serveur)
Si le nom d'utilisateur et mot de passe ne sont pas donnés, les valeurs des options serveur "sasl_username" et "sasl_password" (ou "sasl_key") sont utilisées.
Exemples :
s'authentifier avec le nom d'utilisateur et mot de passe défini dans le serveur :
/auth
s'authentifier avec un utilisateur différent :
/auth utilisateur2 mot_de_passe2
s'authentifier avec un utilisateur différent et le mécanisme ecdsa-nist256p-challenge :
/auth utilisateur2 ${weechat_config_dir}/ecdsa2.pem
----
[[command_irc_ban]]
* `+ban+`: bannir des pseudos ou hôtes
----
/ban [<canal>] [<pseudo> [<pseudo>...]]
canal : nom du canal
pseudo : pseudo ou hôte
Sans paramètre, cette commande affiche la liste des bannissements pour le canal courant.
----
[[command_irc_cap]]
* `+cap+`: négociation de capacité client
----
/cap ls
list
req|ack [<capacité> [<capacité>...]]
end
ls : lister les capacités supportées par le serveur
list : lister les capacités actuellement activées
req : demander une capacité
ack : accuser réception de capacités qui nécessitent un accusé de réception du client
end : terminer la négociation de capacité
Sans paramètre, "ls" et "list" sont envoyés.
Les capacités supportées par WeeChat sont : account-notify, away-notify, cap-notify, chghost, extended-join, invite-notify, message-tags, multi-prefix, server-time, setname, userhost-in-names.
Les capacités à activer automatiquement sur les serveurs peuvent être définies dans l'option irc.server_default.capabilities (ou par serveur dans l'option irc.server.xxx.capabilities).
Exemples :
/cap
/cap req multi-prefix away-notify
----
[[command_irc_connect]]
* `+connect+`: se connecter à un/plusieurs serveur(s) IRC
----
/connect [<serveur> [<serveur>...]] [-<option>[=<valeur>]] [-no<option>] [-nojoin] [-switch]
-all|-auto|-open [-nojoin] [-switch]
serveur : nom du serveur, qui peut être :
- nom interne de serveur (ajouté par /server add, usage recommandé)
- nom/port ou IP/port, le port par défaut est 6667
- URL avec le format : irc[6][s]://[pseudo[:mot_passe]@]irc.example.org[:port][/#canal1][,#canal2[...]]
Note : pour une adresse/IP/URL, un serveur temporaire est ajouté (NON SAUVÉ), voir /help irc.look.temporary_servers
option : définir l'option pour le serveur (pour une option booléenne, la valeur peut être omise)
nooption : définir l'option booléenne à 'off' (par exemple : -nossl)
-all : se connecter à tous les serveurs définis dans la configuration
-auto : se connecter aux serveurs qui ont "autoconnect" activé
-open : se connecter à tous les serveurs ouverts qui ne sont pas actuellement connectés
-nojoin : ne rejoindre aucun canal (même si l'autojoin est activé pour le serveur)
-switch : basculer vers l'adresse suivante du serveur
Pour se déconnecter du serveur ou stopper toute tentative de connexion, utilisez la commande /disconnect.
Exemples :
/connect libera
/connect irc.oftc.net/6667
/connect irc6.oftc.net/6667 -ipv6
/connect irc6.oftc.net/6697 -ipv6 -ssl
/connect my.server.org/6697 -ssl -password=test
/connect irc://nick@irc.oftc.net/#channel
/connect -switch
----
[[command_irc_ctcp]]
* `+ctcp+`: envoyer un message CTCP (Client-To-Client Protocol)
----
/ctcp [-server <serveur>] <cible>[,<cible>...] <type> [<paramètres>]
server : envoyer à ce serveur (nom interne)
cible : pseudo ou nom de canal ('*' = canal courant)
type : type de CTCP (exemples : "version", "ping", etc.)
arguments : paramètres pour le CTCP
Exemples :
/ctcp toto time
/ctcp toto version
/ctcp * version
----
[[command_irc_cycle]]
* `+cycle+`: quitter et rejoindre un canal
----
/cycle [<canal>[,<canal>...]] [message]
canal : nom du canal à quitter
message : message de fin (affiché aux autres utilisateurs)
----
[[command_irc_dcc]]
* `+dcc+`: démarrer un DCC (transfert de fichier ou discussion directe)
----
/dcc chat <pseudo>
send <pseudo> <fichier>
pseudo : pseudo
fichier : nom du fichier (sur la machine locale)
Exemples :
discuter avec le pseudo "toto" :
/dcc chat toto
envoyer le fichier "/home/foo/bar.txt" au pseudo "toto" :
/dcc send toto /home/foo/bar.txt
----
[[command_irc_dehalfop]]
* `+dehalfop+`: retirer le statut de demi-opérateur du canal à/aux pseudo(s)
----
/dehalfop <pseudo> [<pseudo>...]
* -yes
pseudo : pseudo ou masque (le caractère joker "*" est autorisé)
* : retirer le statut de demi-opérateur de tout le monde sur le canal excepté vous-même
----
[[command_irc_deop]]
* `+deop+`: retirer le statut d'opérateur du canal à/aux pseudo(s)
----
/deop <pseudo> [<pseudo>...]
* -yes
pseudo : pseudo ou masque (le caractère joker "*" est autorisé)
* : retirer le statut d'opérateur de tout le monde sur le canal excepté vous-même
----
[[command_irc_devoice]]
* `+devoice+`: retirer la voix du/des pseudo(s)
----
/devoice <pseudo> [<pseudo>...]
* -yes
pseudo : pseudo ou masque (le caractère joker "*" est autorisé)
* : retirer la voix de tout le monde sur le canal
----
[[command_irc_die]]
* `+die+`: arrêter le serveur
----
/die [<cible>]
cible : nom du serveur
----
[[command_irc_disconnect]]
* `+disconnect+`: se déconnecter d'un ou de tous les serveurs IRC
----
/disconnect [<serveur>|-all|-pending [<raison>]]
serveur : nom interne du serveur
-all : se déconnecter de tous les serveurs
-pending : annuler la reconnexion automatique sur les serveurs en cours de reconnexion
raison : raison pour le "quit"
----
[[command_irc_halfop]]
* `+halfop+`: donner le statut de demi-opérateur à un/des pseudo(s)
----
/halfop <pseudo> [<pseudo>...]
* -yes
pseudo : pseudo ou masque (le caractère joker "*" est autorisé)
* : donner le statut de demi-opérateur à tout le monde sur le canal
----
[[command_irc_ignore]]
* `+ignore+`: ignorer des pseudos/hôtes de serveurs ou canaux
----
/ignore list
add [re:]<pseudo> [<serveur> [<canal>]]
del <numéro>|-all
list : lister tous les ignores
add : ajouter un ignore
pseudo : pseudo ou hôte (peut être une expression régulière POSIX étendue si "re:" est donné ou un masque avec "*" pour remplacer zéro ou plusieurs caractères)
del : supprimer un ignore
numéro : numéro du ignore à supprimer (voir la liste des ignore pour le trouver)
-all : supprimer tous les ignores
serveur : nom de serveur interne où l'ignore fonctionnera
canal : canal où l'ignore fonctionnera
Note : l'expression régulière peut commencer par "(?-i)" pour devenir sensible à la casse.
Exemples :
ignorer le pseudo "toto" partout :
/ignore add toto
ignorer le hôte "toto@domain.com" sur le serveur libera :
/ignore add toto@domain.com libera
ignorer le hôte "toto*@*.domain.com" sur libera/#weechat :
/ignore add toto*@*.domain.com libera #weechat
----
[[command_irc_info]]
* `+info+`: voir les informations décrivant le serveur
----
/info [<cible>]
cible : nom du serveur
----
[[command_irc_invite]]
* `+invite+`: inviter un pseudo sur un canal
----
/invite <pseudo> [<pseudo>...] [<canal>]
pseudo : pseudo
canal : canal
----
[[command_irc_ison]]
* `+ison+`: vérifier si un pseudo est actuellement sur IRC
----
/ison <pseudo> [<pseudo>...]
pseudo : pseudo
----
[[command_irc_join]]
* `+join+`: rejoindre un canal
----
/join [-noswitch] [-server <serveur>] [<canal1>[,<canal2>...]] [<clé1>[,<clé2>...]]
-noswitch : ne pas basculer sur le nouveau tampon
serveur : envoyer à ce serveur (nom interne)
canal : nom du canal à rejoindre
clé : clé pour rejoindre le canal (les canaux avec une clé doivent être les premiers dans la liste)
Exemples :
/join #weechat
/join #protectedchan,#weechat key
/join -server libera #weechat
/join -noswitch #weechat
----
[[command_irc_kick]]
* `+kick+`: éjecter un utilisateur d'un canal
----
/kick [<canal>] <pseudo> [<raison>]
canal : nom du canal
pseudo : pseudo
raison : raison (évaluée, voir /help eval ; les variables spéciales ${nick} (propre pseudo), ${target} (pseudo cible), ${channel} et ${server} sont remplacées par leur valeurs)
----
[[command_irc_kickban]]
* `+kickban+`: éjecter un utilisateur d'un canal et bannir l'hôte
----
/kickban [<canal>] <pseudo> [<raison>]
canal : nom du canal
pseudo : pseudo
raison : raison (évaluée, voir /help eval ; les variables spéciales ${nick} (propre pseudo), ${target} (pseudo cible), ${channel} et ${server} sont remplacées par leur valeurs)
Il est possible d'éjecter/bannir avec un masque, le pseudo sera extrait du masque et remplacé par "*".
Exemple :
bannir "*!*@host.com" puis éjecter "toto" :
/kickban toto!*@host.com
----
[[command_irc_kill]]
* `+kill+`: fermer la connexion client-serveur
----
/kill <pseudo> [<raison>]
pseudo : pseudo
raison : raison
----
[[command_irc_links]]
* `+links+`: lister tous les noms de serveurs connus du serveur qui répondent à la requête
----
/links [[<cible>] <masque_serveur>]
cible : ce serveur doit répondre à la requête
masque_serveur : liste des serveurs correspondant au masque
----
[[command_irc_list]]
* `+list+`: lister les canaux et leurs titres
----
/list [-server <serveur>] [-re <regex>] [<canal>[,<canal>...]] [<cible>]
serveur : envoyer à ce serveur (nom interne)
regex : expression régulière POSIX étendue utilisée pour filtrer les résultats (insensible à la casse, peut commencer par "(?-i)" pour devenir sensible à la casse)
canal : canal à lister
cible : nom du serveur
Exemples :
lister tous les canaux du serveur (peut être très lent pour les grands réseaux) :
/list
lister le canal #weechat :
/list #weechat
lister tous les canaux commençant par "#weechat" (peut être très lent pour les grands réseaux) :
/list -re #weechat.*
----
[[command_irc_lusers]]
* `+lusers+`: obtenir des statistiques sur la taille du réseau IRC
----
/lusers [<masque> [<cible>]]
masque : serveurs qui correspondent au masque seulement
cible : serveur pour faire suivre la requête
----
[[command_irc_map]]
* `+map+`: afficher une carte graphique du réseau IRC
----
----
[[command_irc_me]]
* `+me+`: envoyer une action CTCP au canal courant
----
/me <message>
message : message à envoyer
----
[[command_irc_mode]]
* `+mode+`: changer le mode du canal ou de l'utilisateur
----
/mode [<canal>] [+|-]o|p|s|i|t|n|m|l|b|e|v|k [<paramètres>]
<pseudo> [+|-]i|s|w|o
modes de canaux :
canal : nom du canal à modifier (par défaut le canal courant)
o : donner/reprendre le statut privilégié d'opérateur
p : indicateur de canal privé
s : indicateur de canal secret
i : indicateur de canal avec invitation seulement
t : le titre est modifiable seulement par un opérateur du canal
n : aucun message au canal depuis l'extérieur
m : canal modéré
l : fixer la limite d'utilisateurs pour le canal
b : paramétrer un masque de bannissement pour garder des utilisateurs dehors
e : paramétrer un masque d'exception
v : donner/reprendre la possibilité de parler sur un canal modéré
k : définir une clé (mot de passe) pour accéder au canal
modes utilisateur :
pseudo : pseudo à modifier
i : marquer un utilisateur comme invisible
s : marquer un utilisateur pour recevoir les notices du serveur
w : l'utilisateur reçoit les wallops
o : drapeau opérateur
La liste des modes n'est pas exhaustive, vous devriez lire la documentation de votre serveur pour voir tous les modes possibles.
Exemples :
protéger le titre du canal #weechat :
/mode #weechat +t
devenir invisible sur le serveur :
/mode nick +i
----
[[command_irc_motd]]
* `+motd+`: obtenir le message du jour
----
/motd [<cible>]
cible : nom du serveur
----
[[command_irc_msg]]
* `+msg+`: envoyer un message à un pseudo ou canal
----
/msg [-server <serveur>] <cible>[,<cible>...] <texte>
serveur : envoyer à ce serveur (nom interne)
cible : pseudo ou canal (peut-être un masque, '*' = canal courant)
texte : texte à envoyer
----
[[command_irc_names]]
* `+names+`: lister les pseudos sur des canaux
----
/names [<canal>[,<canal>...]]
canal : nom du canal
----
[[command_irc_nick]]
* `+nick+`: changer le pseudo courant
----
/nick [-all] <pseudo>
-all : définir le nouveau pseudo sur tous les serveurs connectés
pseudo : nouveau pseudo
----
[[command_irc_notice]]
* `+notice+`: envoyer un message notice à un utilisateur
----
/notice [-server <serveur>] <cible> <texte>
serveur : envoyer à ce serveur (nom interne)
cible : pseudo ou nom de canal
texte : texte à envoyer
----
[[command_irc_notify]]
* `+notify+`: ajouter une notification de présence ou de statut d'absence pour des pseudos sur les serveurs
----
/notify add <pseudo> [<serveur> [-away]]
del <pseudo>|-all [<serveur>]
add : ajouter une notification
pseudo : pseudo
serveur : nom interne du serveur (par défaut le serveur courant)
-away : notifier quand le message d'absence est changé (en faisant un whois sur le pseudo)
del : supprimer une notification
-all : supprimer toutes les notifications
Sans paramètre, cette commande affiche les notifications pour le serveur courant (ou tous les serveurs si la commande est exécutée sur le tampon "core").
Exemples :
notifier quand "toto" rejoint/quitte le serveur courant :
/notify add toto
notifier quand "toto" rejoint/quitte le serveur libera :
/notify add toto libera
notifier quand "toto" est absent ou de retour sur le serveur libera :
/notify add toto libera -away
----
[[command_irc_op]]
* `+op+`: donner le statut d'opérateur à un/des pseudo(s)
----
/op <pseudo> [<pseudo>...]
* -yes
pseudo : pseudo ou masque (le caractère joker "*" est autorisé)
* : donner le statut d'opérateur à tout le monde sur le canal
----
[[command_irc_oper]]
* `+oper+`: obtenir le statut d'opérateur
----
/oper <utilisateur> <mot_de_passe>
utilisateur : utilisateur
mot_de_passe : mot de passe
----
[[command_irc_part]]
* `+part+`: quitter un canal
----
/part [<canal>[,<canal>...]] [message]
canal : canal à quitter
message : message de fin (affiché aux autres utilisateurs)
----
[[command_irc_ping]]
* `+ping+`: envoyer un ping au serveur
----
/ping <cible1> [<cible2>]
cible1 : serveur
cible2 : faire suivre le ping à ce serveur
----
[[command_irc_pong]]
* `+pong+`: répondre à un message ping
----
/pong <démon> [<démon2>]
démon : démon qui a répondu au message Ping
démon2 : faire suivre le message à ce démon
----
[[command_irc_query]]
* `+query+`: envoyer un message privé à un pseudo
----
/query [-noswitch] [-server <serveur>] <pseudo>[,<pseudo>...] [<texte>]
-noswitch : ne pas basculer sur le nouveau tampon
serveur : envoyer à ce serveur (nom interne)
pseudo : pseudo
texte : texte à envoyer
----
[[command_irc_quiet]]
* `+quiet+`: faire taire des pseudos ou hôtes
----
/quiet [<canal>] [<pseudo> [<pseudo>...]]
canal : nom du canal
pseudo : pseudo ou hôte
Sans paramètre, cette commande affiche la liste des "quiet" pour le canal courant.
----
[[command_irc_quote]]
* `+quote+`: envoyer des données brutes au serveur sans analyse
----
/quote [-server <serveur>] <données>
serveur : envoyer à ce serveur (nom interne)
données : données brutes à envoyer
----
[[command_irc_reconnect]]
* `+reconnect+`: se reconnecter à un/plusieurs serveur(s)
----
/reconnect <serveur> [<serveur>...] [-nojoin] [-switch]
-all [-nojoin] [-switch]
serveur : serveur pour se reconnecter (nom interne)
-all : se reconnecter à tous les serveurs
-nojoin : ne rejoindre aucun canal (même si l'autojoin est activé pour le serveur)
-switch : basculer vers l'adresse suivante du serveur
----
[[command_irc_rehash]]
* `+rehash+`: demander au serveur de recharger son fichier de configuration
----
/rehash [<option>]
option : option supplémentaire, pour certains serveurs
----
[[command_irc_remove]]
* `+remove+`: forcer un utilisateur à quitter un canal
----
/remove [<canal>] <pseudo> [<raison>]
canal : nom du canal
pseudo : pseudo
raison : raison (les variables spéciales $nick, $channel et $server sont remplacées par leurs valeurs)
----
[[command_irc_restart]]
* `+restart+`: demander au serveur de redémarrer
----
/restart [<cible>]
cible : nom du serveur
----
[[command_irc_sajoin]]
* `+sajoin+`: forcer un utilisateur à rejoindre un ou plusieurs canaux
----
/sajoin <pseudo> <canal>[,<canal>...]
pseudo : pseudo
canal : canal
----
[[command_irc_samode]]
* `+samode+`: changer le mode du canal, sans avoir le statut d'opérateur
----
/samode [<canal>] <mode>
canal : nom du canal
mode : mode pour le canal
----
[[command_irc_sanick]]
* `+sanick+`: forcer un utilisateur à utiliser un autre pseudo
----
/sanick <pseudo> <nouveau_pseudo>
pseudo : pseudo
nouveau_pseudo : nouveau pseudo
----
[[command_irc_sapart]]
* `+sapart+`: forcer un utilisateur à quitter un ou plusieurs canaux
----
/sapart <pseudo> <canal>[,<canal>...]
pseudo : pseudo
canal : canal
----
[[command_irc_saquit]]
* `+saquit+`: forcer un utilisateur à quitter le serveur avec une raison
----
/saquit <pseudo> <raison>
pseudo : pseudo
raison : raison
----
[[command_irc_server]]
* `+server+`: lister, ajouter ou retirer des serveurs IRC
----
/server list|listfull [<nom>]
add <nom> <nom_machine>[/<port>] [-temp] [-<option>[=<valeur>]] [-no<option>]
copy|rename <nom> <nouveau_nom>
reorder <nom> [<nom>...]
open <nom>|-all [<nom>...]
del|keep <nom>
deloutq|jump
raw [<filtre>]
list : afficher les serveurs (sans paramètre, cette liste est affichée)
listfull : afficher les serveurs avec de l'info détaillée pour chaque
add : ajouter un nouveau serveur
nom : nom du serveur, pour usage interne et affichage ; ce nom est utilisé pour se connecter au serveur (/connect nom) et pour définir les options du serveur : irc.server.name.xxx
nom_machine : nom ou adresse IP du serveur avec port en option (défaut : 6667), plusieurs adresses peuvent être séparées par une virgule
-temp : ajouter un serveur temporaire (non sauvé)
option : définir l'option pour le serveur (pour une option booléenne, la valeur peut être omise)
nooption : définir l'option booléenne à 'off' (par exemple : -nossl)
copy : dupliquer un serveur
rename : renommer un serveur
reorder : réordonner la liste des serveurs
open : ouvrir le tampon du serveur sans s'y connecter
keep : garder le serveur dans le fichier de configuration (pour les serveurs temporaires seulement)
del : supprimer un serveur
deloutq : supprimer la file d'attente des messages sortants pour tous les serveurs (tous les messages que WeeChat est actuellement en train d'envoyer)
jump : sauter au tampon du serveur
raw : ouvrir le tampon avec les données brutes IRC
filtre : définir un nouveau filtre pour voir seulement les messages correspondants (ce filtre peut aussi être utilisé en entrée du tampon des données brutes) ; les formats autorisés sont :
* afficher tous les messages (pas de filtre)
xxx afficher seulement les messages contenant "xxx"
s:xxx afficher seulement les messages pour le serveur "xxx"
f:xxx afficher seulement les messages avec un drapeau : recv (message reçu), sent (message envoyé), modified (message modifié par un modificateur), redirected (message redirigé)
m:xxx afficher seulement les messages pour la commande IRC "xxx"
c:xxx afficher seulement les messages qui correspondent à la condition évaluée "xxx", en utilisant les variables suivantes : sortie de la fonction irc_message_parse (comme nick, command, channel, text, etc., voir la fonction info_get_hashtable dans la référence API extension pour la liste de toutes les variables), date (format : "yyyy-mm-dd hh:mm:ss"), server, recv, sent, modified, redirected
Exemples :
/server listfull
/server add libera irc.libera.chat
/server add libera irc.libera.chat/6697 -ssl -autoconnect
/server add chatspike irc.chatspike.net/6667,irc.duckspike.net/6667
/server copy libera libera-test
/server rename libera-test libera2
/server reorder libera2 libera
/server del libera
/server deloutq
/server raw
/server raw s:libera
/server raw c:${recv} && ${command}==PRIVMSG && ${nick}==foo
----
[[command_irc_service]]
* `+service+`: enregistrer un nouveau service
----
/service <pseudo> <réservé> <distribution> <type> <réservé> <info>
distribution : visibilité du service
type : réservé pour une utilisation future
----
[[command_irc_servlist]]
* `+servlist+`: lister les services actuellement connectés au réseau
----
/servlist [<masque> [<type>]]
masque : lister seulement les services qui correspondent à ce masque
type : lister seulement les services de ce type
----
[[command_irc_setname]]
* `+setname+`: définir le nom réel
----
/setname <nom_réel>
nom_réel : nouveau nom réel
----
[[command_irc_squery]]
* `+squery+`: envoyer un message à un service
----
/squery <service> <texte>
service : nom du service
texte : texte à envoyer
----
[[command_irc_squit]]
* `+squit+`: déconnecter les liens vers un serveur
----
/squit <cible> <commentaire>
cible : nom du serveur
commentaire : commentaire
----
[[command_irc_stats]]
* `+stats+`: demander des statistiques sur le serveur
----
/stats [<requête> [<cible>]]
requête : c/h/i/k/l/m/o/y/u (voir la RFC1459)
cible : nom du serveur
----
[[command_irc_summon]]
* `+summon+`: envoyer aux utilisateurs d'un serveur IRC un message leur demandant de rejoindre IRC
----
/summon <utilisateur> [<cible> [<canal>]]
utilisateur : nom d'utilisateur
cible : nom du serveur
canal : nom du canal
----
[[command_irc_time]]
* `+time+`: demander l'heure locale de serveur
----
/time [<cible>]
cible : demander l'heure de ce serveur
----
[[command_irc_topic]]
* `+topic+`: recevoir/définir le titre du canal
----
/topic [<canal>] [<titre>|-delete]
canal : nom du canal
titre : nouveau titre
-delete : supprimer le titre du canal
----
[[command_irc_trace]]
* `+trace+`: trouver le chemin jusqu'à un serveur spécifique
----
/trace [<cible>]
cible : nom du serveur
----
[[command_irc_unban]]
* `+unban+`: supprimer le bannissement sur des pseudos ou hôtes
----
/unban [<canal>] <pseudo>|<nombre> [<pseudo>|<nombre>...]
canal : nom du canal
pseudo : pseudo ou hôte
nombre : numéro de bannissement (comme affiché par la commande /ban)
----
[[command_irc_unquiet]]
* `+unquiet+`: ne plus taire des pseudos ou hôtes
----
/unquiet [<canal>] <pseudo>|<nombre> [<pseudo>|<nombre>...]
canal : nom du canal
pseudo : pseudo ou hôte
nombre : numéro de "quiet" (comme affiché par la commande /quiet)
----
[[command_irc_userhost]]
* `+userhost+`: retourner une liste d'informations sur des pseudos
----
/userhost <pseudo> [<pseudo>...]
pseudo : pseudo
----
[[command_irc_users]]
* `+users+`: liste des utilisateurs connectés au serveur
----
/users [<cible>]
cible : nom du serveur
----
[[command_irc_version]]
* `+version+`: retourner la version du pseudo ou du serveur (courant ou spécifié)
----
/version [<cible>|<pseudo>]
cible : nom du serveur
pseudo : pseudo
----
[[command_irc_voice]]
* `+voice+`: donner la voix à/aux pseudo(s)
----
/voice <pseudo> [<pseudo>...]
* -yes
pseudo : pseudo ou masque (le caractère joker "*" est autorisé)
* : donner la voix à tout le monde sur le canal
----
[[command_irc_wallchops]]
* `+wallchops+`: envoyer une notice aux opérateurs du canal
----
/wallchops [<canal>] <texte>
canal : nom du canal
texte : texte à envoyer
----
[[command_irc_wallops]]
* `+wallops+`: envoyer un message à tous les utilisateurs connectés qui ont activé le mode utilisateur 'w' pour eux-mêmes
----
/wallops <texte>
texte : texte à envoyer
----
[[command_irc_who]]
* `+who+`: générer une requête qui retourne une liste d'information
----
/who [<masque> [o]]
masque : information qui correspond à ce masque uniquement
o : seuls les opérateurs sont retournés correspondant au masque fourni
----
[[command_irc_whois]]
* `+whois+`: demander les informations sur le(s) utilisateur(s)
----
/whois [<cible>] [<pseudo>[,<pseudo>...]]
cible : nom de serveur
pseudo : pseudo (peut être un masque)
Sans paramètre, cette commande effectuera un whois sur :
- votre propre pseudo si le tampon est un serveur/canal
- le pseudo distant si le tampon est un privé.
Si l'option irc.network.whois_double_nick est activée, deux pseudos sont envoyés (si un seul est donné), pour avoir le temps d'inactivité dans la réponse.
----
[[command_irc_whowas]]
* `+whowas+`: demander de l'information sur un pseudo qui n'existe plus
----
/whowas <pseudo>[,<pseudo>...] [<nombre> [<cible>]]
pseudo : pseudo
nombre : nombre de réponses à retourner (recherche complète si nombre négatif)
cible : la réponse doit correspondre à ce masque
----
// end::irc_commands[]
// tag::alias_commands[]
[[command_alias_alias]]
* `+alias+`: lister, ajouter ou retirer des alias de commande
----
/alias list [<alias>]
add <alias> [<commande>[;<commande>...]]
addcompletion <complétion> <alias> [<commande>[;<commande>...]]
del <alias> [<alias>...]
list : afficher les alias (sans paramètre, cette liste est affichée)
add : ajouter un alias
addcompletion : ajouter un alias avec une complétion personnalisée
del : supprimer un alias
complétion : complétion pour l'alias : par défaut la complétion se fait avec la commande cible
note : vous pouvez utiliser %%commande pour utiliser la complétion d'une commande existante
alias : nom de l'alias
commande : nom de la commande avec les paramètres (plusieurs commandes peuvent être séparées par des points-virgules)
Note : dans la commande, les variables spéciales sont remplacées :
$n : paramètre 'n' (entre 1 et 9)
$-m : paramètres de 1 à 'm'
$n- : paramètres de 'n' au dernier
$n-m : paramètres de 'n' à 'm'
$* : tous les paramètres
$~ : le dernier paramètre
$var : où "var" est une variable locale du tampon (voir /buffer listvar)
exemples : $nick, $channel, $server, $plugin, $name
Exemples :
alias /split pour diviser la fenêtre horizontalement :
/alias add split /window splith
alias /hello pour dire "hello" sur tous les canaux mais pas sur #weechat :
/alias add hello /allchan -exclude=#weechat hello
alias /forcejoin pour envoyer la commande IRC "forcejoin" avec la complétion de /sajoin :
/alias addcompletion %%sajoin forcejoin /quote forcejoin
----
// end::alias_commands[]
// tag::weechat_commands[]
[[command_weechat_away]]
* `+away+`: définir ou supprimer le statut d'absence
----
/away [-all] [<message>]
-all : définir ou supprimer le statut d'absence sur tous les serveurs connectés
message : message pour l'absence (si pas de message donné, le statut d'absence est supprimé)
----
[[command_weechat_bar]]
* `+bar+`: gestion des barres
----
/bar list|listfull|listitems
add <nom> <type>[,<conditions>] <position> <taille> <séparateur> <objet1>[,<objet2>...]
default [input|title|status|nicklist]
del <nom>|-all
set <nom> <option> <valeur>
hide|show|toggle <nom>
scroll <nom> <fenêtre> <valeur_scroll>
list : lister toutes les barres
listfull : lister toutes les barres (verbeux)
listitems : lister tous les objets de barre
add : ajouter une nouvelle barre
nom : nom de la barre (doit être unique)
type : root : en dehors des fenêtres
window : dans les fenêtres, avec condition(s) optionnelle(s) (voir ci-dessous)
conditions : les conditions pour afficher la barre :
active : sur la fenêtre active
inactive : sur les fenêtres inactives
nicklist : sur les fenêtres avec liste de pseudos
autre condition : voir /help weechat.bar.xxx.conditions et /help eval
sans condition, la barre est toujours affichée
position : bottom (bas), top (haut), left (gauche) ou right (droite)
taille : taille de la barre (en caractères)
séparateur : 1 pour utiliser un séparateur (ligne), 0 ou rien signifie sans séparateur
objet1,... : objets pour cette barre (les objets peuvent être séparés par une virgule (espace entre les objets) ou "+" (objets collés))
default : créer une barre par défaut (toutes les barres par défaut si aucun nom de barre n'est donné)
del : supprimer une barre (ou toutes les barres avec -all)
set : changer la valeur d'une propriété de la barre
option : option à modifier (pour la liste des options, voir /set weechat.bar.<nombarre>.*)
valeur : nouvelle valeur pour l'option
hide : cacher la barre
show : montrer une barre cachée
toggle : cacher/montrer une barre
scroll : faire défiler la barre
fenêtre : numéro de fenêtre (utilisez '*' pour la fenêtre courante ou une barre de type root)
valeur_scroll : valeur pour le défilement : 'x' ou 'y' (optionnel), suivi par '+', '-', 'b' (début) ou 'e' (fin), valeur (pour +/-), et un % optionnel (pour faire défiler par % de la largeur/hauteur, sinon la valeur est un nombre de caractères)
Exemples :
créer une barre avec l'heure, numéro + nom de tampon, et la complétion :
/bar add mabarre root bottom 1 0 [time],buffer_number+:+buffer_name,completion
cacher une barre :
/bar hide mabarre
faire défiler la liste des pseudos de 10 lignes vers le bas sur le tampon courant :
/bar scroll nicklist * y+10
faire défiler la liste des pseudos à la fin sur le tampon courant :
/bar scroll nicklist * ye
----
[[command_weechat_buffer]]
* `+buffer+`: gestion des tampons
----
/buffer list
add [-free] [-switch] <nom>
clear [<nombre>|<nom>|-merged|-all [<nombre>|<nom>...]]
move <nombre>|-|+
swap <nombre1>|<nom1> [<nombre2>|<nom2>]
cycle <nombre>|<nom> [<nombre>|<nom>...]
merge <nombre>|<nom>
unmerge [<nombre>|-all]
hide [<nombre>|<nom>|-all [<nombre>|<nom>...]]
unhide [<nombre>|<nom>|-all [<nombre>|<nom>...]]
renumber <nombre1> [<nombre2> [<départ>]]
close [<n1>[-<n2>]|<nom>...]
notify [<niveau>]
listvar [<nombre>|<nom>]
setvar <nom> [<valeur>]
delvar <nom>
set <propriété> [<valeur>]
get <propriété>
<nombre>|<nom>
list : lister les tampons ouverts (sans paramètre, cette liste est affichée)
add : ajouter un nouveau tampon (il peut être fermé avec "/buffer close" ou l'entrée "q")
clear : effacer le contenu du tampon (un numéro pour un tampon, -merged pour les tampons mélangés, -all pour tous les tampons, ou rien pour le tampon courant)
move : déplacer le tampon dans la liste (peut être relatif, par exemple -1) ; "-" = déplacer vers le premier numéro de tampon, "+" = déplacer vers le dernier numéro de tampon + 1
swap : échanger deux tampons (échanger avec le tampon courant si un seul numéro/nom donné)
cycle : sauter en boucle entre une liste de plusieurs tampons
merge : mélanger le tampon courant avec un autre tampon (la zone de discussion sera un mélange des deux tampons)
(par défaut ctrl-x bascule entre les tampons mélangés)
unmerge : détacher le tampon courant des autres tampons portant le même numéro
hide : masquer le tampon
unhide : démasquer le tampon
renumber : renuméroter des tampons (fonctionne seulement si l'option weechat.look.buffer_auto_renumber est désactivée)
close : fermer le tampon (nombre/intervalle ou nom optionnel)
notify : afficher ou définir le niveau de notification pour le tampon courant : ce niveau détermine si le tampon doit être ajouté à la hotlist ou pas :
none : jamais
highlight : pour les highlights seulement
message : pour les messages d'utilisateurs + highlights
all : pour tous les messages
reset : réinitialise à valeur par défaut (all)
listvar : afficher la liste des variables locales d'un tampon
setvar : modifier une variable locale du tampon courant
delvar : supprimer une variable locale du tampon courant
set : modifier une propriété du tampon courant
get : afficher une propriété du tampon courant
nombre : sauter au tampon qui a ce numéro, préfixe possible :
'+' : saut relatif, ajoute le numéro au courant,
'-' : saut relatif, soustrait le numéro au courant,
'*' : saut au numéro en utilisant l'option "jump_current_to_previous_buffer"
- : sauter au premier numéro de tampon
+ : sauter au dernier numéro de tampon
nom : sauter au tampon par nom (partiel)
Exemples :
effacer le tampon courant :
/buffer clear
déplacer le tampon vers le numéro 5 :
/buffer move 5
échanger le tampon 1 avec le 3 :
/buffer swap 1 3
échanger le tampon #weechat avec le tampon courant :
/buffer swap #weechat
sauter sur #canal1, #canal2, #canal3 en boucle :
/buffer cycle #canal1 #canal2 #canal3
mélanger avec le tampon core :
/buffer merge 1
mélanger avec le tampon #weechat :
/buffer merge #weechat
détacher le tampon :
/buffer unmerge
fermer le tampon courant :
/buffer close
fermer les tampons 5 à 7 :
/buffer close 5-7
aller sur #weechat :
/buffer #weechat
aller au tampon suivant :
/buffer +1
aller au dernier numéro de tampon :
/buffer +
----
[[command_weechat_color]]
* `+color+`: définir des alias de couleurs et afficher la palette des couleurs
----
/color alias <couleur> <nom>
unalias <couleur>
reset
term2rgb <color>
rgb2term <rgb> [<limit>]
-o
alias : ajouter un alias pour une couleur
unalias : supprimer un alias pour une couleur
couleur : numéro de couleur (supérieur ou égal à 0, le max dépend du terminal, généralement 63 ou 255)
nom : nom d'alias pour la couleur (par exemple : "orange")
reset : réinitialiser toutes les paires de couleurs (requis quand il n'y a plus de paires de couleurs disponibles si la réinitialisation automatique est désactivée, voir l'option "weechat.look.color_pairs_auto_reset")
term2rgb : convertir une couleur du terminal (0-255) en couleur RGB
rgb2term : convertir une couleur RGB en couleur du terminal (0-255)
limite : nombre de couleurs à utiliser dans la table du terminal (en démarrant de 0) ; par défaut 256
-o : envoyer les infos terminal/couleurs sur le tampon courant comme entrée
Sans paramètre, cette commande affiche les couleurs dans un nouveau tampon.
Exemples :
ajouter l'alias "orange" pour la couleur 214 :
/color alias 214 orange
supprimer la couleur 214 :
/color unalias 214
----
[[command_weechat_command]]
* `+command+`: lancer explicitement une commande WeeChat ou d'une extension
----
/command [-buffer <nom>] <extension> <commande>
-buffer : exécuter la commande sur ce tampon
extension : exécuter la commande de cette extension ; 'core' pour une commande WeeChat, '*' pour une extension automatique (cela dépend sur quel tampon est exécutée la commande)
commande : commande à exécuter (un '/' est automatiquement ajouté s'il n'est pas trouvé au début de la commande)
----
[[command_weechat_cursor]]
* `+cursor+`: mouvement libre du curseur sur l'écran pour exécuter des actions sur des zones spécifiques de l'écran
----
/cursor go chat|<barre>|<x>,<y>
move up|down|left|right|area_up|area_down|area_left|area_right
stop
go : déplacer le curseur vers la zone de discussion ("chat"), une barre (en utilisant son nom) ou les coordonnées "x,y"
move : déplacer le curseur dans une direction
stop : arrêter le mode curseur
Sans paramètre, cette commande active/désactive le mode curseur.
Lorsque la souris est activée (voir /help mouse), par défaut un clic du milieu démarre le mode curseur à ce point.
Touches par défaut dans le mode curseur sur les messages de la zone de discussion :
m citer le message
q citer le préfixe + le message
Q citer l'heure + le préfixe + le message
Touches par défaut dans le mode curseur sur la liste de pseudos :
b bannir le pseudo (/ban)
k éjecter le pseudo (/kick)
K éjecter et bannir le pseudo (/kickban)
q ouvrir une discussion privée avec le pseudo (/query)
w demander les informations sur l'utilisateur (/whois)
Autres touches par défaut dans le mode curseur :
flèche déplacer le curseur
alt+flèche déplacer le curseur vers la zone suivante
entrée sortir du mode curseur
Exemples :
aller dans la liste des pseudos :
/cursor go nicklist
aller aux coordonnées x=10, y=5 :
/cursor go 10,5
----
[[command_weechat_debug]]
* `+debug+`: fonctions de debug
----
/debug list
set <extension> <niveau>
dump [<extension>]
buffer|color|infolists|libs|certs|memory|tags|term|windows
cursor|mouse [verbose]
hdata [free]
time <commande>
list : lister les extensions avec leur niveau de debug
set : définir le niveau de debug pour l'extension
extension : nom de l'extension ("core" pour le cœur de WeeChat)
niveau : niveau de debug pour l'extension
dump : afficher les variables mémoire WeeChat dans le fichier log (les mêmes messages sont affichés lorsque WeeChat plante)
buffer : afficher le contenu du tampon en valeurs hexadécimales dans le fichier log
color : afficher des infos sur les paires de couleur courantes
cursor : activer/désactiver le debug pour le mode curseur
dirs : afficher les répertoires
hdata : afficher des infos sur les hdata (avec free : supprimer tous les hdata en mémoire)
hooks : afficher des infos sur les hooks
infolists : afficher des infos sur les infolists
libs : afficher des infos sur les bibliothèques externes utilisées
certs : afficher le nombre de certificats des autorités de certification chargés
memory : afficher des infos sur l'utilisation de la mémoire
mouse : activer/désactiver le debug pour la souris
tags : afficher les étiquettes pour les lignes
term : afficher des infos sur le terminal
windows : afficher l'arbre des fenêtres
time : mesurer le temps pour exécuter une commande ou pour envoyer du texte au tampon courant
----
[[command_weechat_eval]]
* `+eval+`: évaluer une expression
----
/eval [-n|-s] [-d [-d]] <expression>
[-n] [-d] -c <expression1> <opérateur> <expression2>
-n : afficher le résultat sans envoyer au tampon (mode debug)
-s : découper l'expression avant de l'évaluer (plusieurs commandes peuvent être séparées par des points-virgules)
-d : afficher la sortie de debug après l'évaluation (avec deux -d : mode debug plus verbeux)
-c : évaluer comme une condition : utiliser les opérateurs et les parenthèses, retourner une valeur booléenne ("0" ou "1")
expression : expression à évaluer, les variables avec le format ${variable} sont remplacées (voir ci-dessous) ; plusieurs commandes peuvent être séparées par des points-virgules
opérateur : un opérateur logique ou de comparaison :
- opérateurs logiques :
&& "et" booléen
|| "ou" booléen
- opérateurs de comparaison :
== égal
!= non égal
<= inférieur ou égal
< inférieur
>= supérieur ou égal
> supérieur
=~ correspond à l'expression régulière POSIX étendue
!~ ne correspond PAS à l'expression régulière POSIX étendue
==* correspond au masque, sensible à la casse (le caractère joker "*" est autorisé)
!!* ne correspond PAS au masque, sensible à la casse (le caractère joker "*" est autorisé)
=* correspond au masque, insensible à la casse (le caractère joker "*" est autorisé)
!= ne correspond PAS au masque, insensible à la casse (le caractère joker "*" est autorisé)
==- est inclus, sensible à la casse
!!- n'est PAS inclus, sensible à la casse
=- est inclus, insensible à la casse
!- n'est PAS inclus, insensible à la casse
Une expression est considérée comme "vraie" si elle est non NULL, non vide, et différente de "0".
La comparaison est faite en utilisant des nombres à virgule si les deux expressions sont des nombres valides, avec l'un de ces formats :
- entier (exemples : 5, -7)
- nombre à virgule (exemples : 5.2, -7.5, 2.83e-2)
- nombre hexadécimal (exemples : 0xA3, -0xA3)
Pour forcer une comparaison de chaînes, vous pouvez ajouter des guillemets autour de chaque expression, par exemple :
50 > 100 ==> 0
"50" > "100" ==> 1
Des variables sont remplacées dans l'expression, en utilisant le format ${variable}, la variable pouvant être, par ordre de priorité :
1. la chaîne elle-même sans évaluation (format : "raw:xxx")
2. une sous-chaîne évaluée (format : "eval:xxx")
3. une condition évaluée (format : "eval_cond:xxx")
4. une chaîne avec les caractères échappés (format : "esc:xxx" ou "\xxx")
5. une chaîne avec des caractères à cacher (format : "hide:caractère,chaîne")
6. une chaîne avec un maximum de caractères (format : "cut:max,suffixe,chaîne" ou "cut:+max,suffixe,chaîne")
ou un maximum de caractères affichés à l'écran (format : "cutscr:max,suffixe,chaîne" ou "cutscr:+max,suffixe,chaîne")
7. une chaîne inversée (format : "rev:xxx" ou "revscr:xxx")
8. une chaîne répétée (format : "repeat:nombre,chaîne")
9. longueur d'une chaîne (format : "length:xxx" ou "lengthscr:xxx")
10. une couleur (format : "color:xxx", voir la "Référence API extension", fonction "color")
11. un modificateur (format : "modifier:nom,données,chaîne")
12. une info (format : "info:nom,paramètres", les paramètres sont optionnels)
13. une chaîne encodée/decodée en base 16, 32 ou 64 (format : "base_encode:base,xxx" ou "base_decode:base,xxx")
14. la date/heure courante (format : "date" ou "date:format")
15. une variable d'environnement (format : "env:XXX")
16. un opérateur ternaire (format : "if:condition?valeur_si_vrai:valeur_si_faux")
17. le résultat d'une expression avec parenthèses et les opérateurs + - * / // % ** (format: "calc:xxx")
18. un nombre entier aléatoire (format : "random:min,max")
19. une chaîne traduite (format : "translate:xxx")
20. une option (format : "fichier.section.option")
21. une variable locale du tampon
22. un hdata/variable (la valeur est automatiquement convertie en chaîne), par défaut "window" et "buffer" pointent vers la fenêtre et le tampon courants.
Le format du hdata peut être le suivant :
hdata.var1.var2... : démarrer avec un hdata (le pointeur doit être connu), et demander les variables l'une après l'autre (d'autres hdata peuvent être suivis)
hdata[liste].var1.var2... : démarrer avec un hdata en utilisant une liste/pointeur/nom de pointeur, par exemple :
${buffer[gui_buffers].full_name} : nom complet du premier tampon dans la liste chaînée des tampons
${plugin[weechat_plugins].name} : nom de la première extension dans la liste chaînée des extensions
hdata[pointeur].var1.var2... : démarrer avec un hdata en utilisant un pointeur, par exemple :
${buffer[0x1234abcd].full_name} : nom complet du tampon avec ce pointeur (peut être utilisé dans les triggers)
${buffer[my_pointer].full_name} : nom complet du tampon avec ce nom de pointeur (peut être utilisé dans les triggers)
Pour le nom du hdata et des variables, voir la "Référence API extension", fonction "weechat_hdata_get".
Exemples (chaînes simples) :
/eval -n ${raw:${info:version}} ==> ${info:version}
/eval -n ${eval_cond:${window.win_width}>100} ==> 1
/eval -n ${info:version} ==> 0.4.3
/eval -n ${env:HOME} ==> /home/user
/eval -n ${weechat.look.scroll_amount} ==> 3
/eval -n ${sec.data.password} ==> secret
/eval -n ${window} ==> 0x2549aa0
/eval -n ${window.buffer} ==> 0x2549320
/eval -n ${window.buffer.full_name} ==> core.weechat
/eval -n ${window.buffer.number} ==> 1
/eval -n ${\t} ==> <tab>
/eval -n ${hide:-,${relay.network.password}} ==> --------
/eval -n ${cut:3,+,test} ==> tes+
/eval -n ${cut:+3,+,test} ==> te+
/eval -n ${date:%H:%M:%S} ==> 07:46:40
/eval -n ${if:${info:term_width}>80?big:small} ==> big
/eval -n ${rev:Hello} ==> olleH
/eval -n ${repeat:5,-} ==> -----
/eval -n ${length:test} ==> 4
/eval -n ${calc:(5+2)*3} ==> 21
/eval -n ${random:0,10} ==> 3
/eval -n ${base_encode:64,test} ==> dGVzdA==
/eval -n ${base_decode:64,dGVzdA==} ==> test
/eval -n ${translate:Plugin} ==> Extension
Exemples (conditions) :
/eval -n -c ${window.buffer.number} > 2 ==> 0
/eval -n -c ${window.win_width} > 100 ==> 1
/eval -n -c (8 > 12) || (5 > 2) ==> 1
/eval -n -c (8 > 12) && (5 > 2) ==> 0
/eval -n -c abcd =~ ^ABC ==> 1
/eval -n -c abcd =~ (?-i)^ABC ==> 0
/eval -n -c abcd =~ (?-i)^abc ==> 1
/eval -n -c abcd !~ abc ==> 0
/eval -n -c abcd =* a*d ==> 1
/eval -n -c abcd =- bc ==> 1
----
[[command_weechat_filter]]
* `+filter+`: filtrer les messages dans les tampons, pour les cacher/afficher selon des étiquettes ou expressions régulières
----
/filter list
enable|disable|toggle [<nom>|@]
add|addreplace <nom> <tampon>[,<tampon>...] <étiquettes> <regex>
rename <nom> <nouveau_nom>
recreate <nom>
del <nom>|-all
list : lister tous les filtres
enable : activer les filtres (par défaut les filtres sont activés)
disable : désactiver les filtres
toggle : activer/désactiver les filtres
nom : nom de filtre ("@" = activer/désactiver tous les filtres dans le tampon courant)
add : ajouter un filtre
addreplace : ajouter ou remplacer un filtre existant
rename : renommer un filtre
recreate : définir la ligne de commande utilisée pour modifier le filtre
del : supprimer un filtre
-all : supprimer tous les filtres
tampon : liste des tampons, séparés par des virgules, où le filtre est actif :
- il s'agit du nom complet incluant l'extension (exemple : "irc.libera.#weechat" ou "irc.server.libera")
- "*" signifie tous les tampons
- un nom commençant par '!' est exclu
- le caractère joker "*" est autorisé
étiquettes : liste d'étiquettes, séparées par des virgules, par exemple : "irc_join,irc_part,irc_quit"
- "et" logique : utilisez "+" entre les étiquettes (par exemple : "nick_toto+irc_action")
- le caractère joker "*" est autorisé
- si l'étiquette commence par '!', alors elle est exclue et ne doit PAS être dans le message
regex : expression régulière POSIX étendue à rechercher dans la ligne
- utiliser '\t' pour séparer le préfixe du message, les caractères spéciaux comme '|' doivent être échappés : '\|'
- si l'expression régulière commence par '!' alors le résultat est inversé (utiliser '\!' pour démarrer par '!')
- deux expressions régulières sont créées : une pour le préfixe et une pour le message
- les expressions régulières sont insensibles à la casse, elles peuvent commencer par "(?-i)" pour devenir sensibles à la casse
La touche par défaut alt+'=' active/désactive le filtrage globalement et alt+'-' active/désactive le filtrage sur le tampon courant.
Les étiquettes les plus couramment utilisées :
no_filter, no_highlight, no_log, log0..log9 (niveau de log),
notify_none, notify_message, notify_private, notify_highlight,
self_msg, nick_xxx (xxx est le pseudo dans le message), prefix_nick_ccc (ccc est la couleur du pseudo),
host_xxx (xxx est le nom d'utilisateur + hôte dans le message),
irc_xxx (xxx est un nom de commande ou nombre, voir /server raw ou /debug tags),
irc_numeric, irc_error, irc_action, irc_ctcp, irc_ctcp_reply, irc_smart_filter, away_info.
Pour voir les étiquettes des lignes affichées : /debug tags
Exemples :
utiliser le filtre intelligent IRC sur tous les tampons :
/filter add irc_smart * irc_smart_filter *
utiliser le filtre intelligent IRC sur tous les tampons sauf ceux avec "#weechat" dans le nom :
/filter add irc_smart *,!*#weechat* irc_smart_filter *
filtrer tous les messages IRC join/part/quit :
/filter add joinquit * irc_join,irc_part,irc_quit *
filtrer les pseudos afficher en rejoignant les canaux ou avec /names :
/filter add nicks * irc_366 *
filtrer le pseudo "toto" sur le canal IRC #weechat :
/filter add toto irc.libera.#weechat nick_toto *
filtrer les messages IRC join/action du pseudo "toto" :
/filter add toto * nick_toto+irc_join,nick_toto+irc_action *
filtrer les lignes contenant "weechat sucks" sur le canal IRC #weechat :
/filter add sucks irc.libera.#weechat * weechat sucks
filtrer les lignes qui sont strictement égales à "WeeChat sucks" sur tous les tampons :
/filter add sucks2 * * (?-i)^WeeChat sucks$
----
[[command_weechat_help]]
* `+help+`: afficher l'aide sur les commandes et les options
----
/help -list|-listfull [<extension> [<extension>...]]
<commande>
<option>
-list : lister les commandes, par extension (sans paramètre, cette liste est affichée)
-listfull : lister les commandes avec description, par extension
extension : lister les commandes de cette extension
commande : un nom de commande
option : un nom d'option (utilisez /set pour voir la liste)
----
[[command_weechat_history]]
* `+history+`: afficher l'historique des commandes du tampon
----
/history clear
<valeur>
clear : effacer l'historique
valeur : nombre d'entrées dans l'historique à afficher
----
[[command_weechat_input]]
* `+input+`: fonctions pour la ligne de commande
----
/input <action> [<paramètres>]
liste des actions :
return : simuler la touche "entrée"
complete_next : compléter le mot avec la complétion suivante
complete_previous : compléter le mot avec la complétion précédente
search_text_here : chercher du texte dans le tampon à la position courante
search_text : chercher du texte dans le tampon
search_switch_case : basculer la casse exacte pour la recherche
search_switch_regex : basculer le type de recherche : chaîne/expression régulière
search_switch_where : basculer la recherche dans les messages/préfixes
search_previous : chercher la ligne précédente
search_next : chercher la ligne suivante
search_stop_here : arrêter la recherche à la position courante
search_stop : arrêter la recherche
delete_previous_char : effacer le caractère précédent
delete_next_char : effacer le caractère suivant
delete_previous_word : effacer le mot précédent
delete_next_word : effacer le mot suivant
delete_beginning_of_line : effacer du début de la ligne jusqu'au curseur
delete_end_of_line : effacer du curseur jusqu'à la fin de la ligne
delete_line : effacer la ligne entière
clipboard_paste : coller depuis le presse-papiers interne
transpose_chars : inverser deux caractères
undo : défaire la dernière action de la ligne de commande
redo : refaire la dernière action de la ligne de commande
move_beginning_of_line : déplacer le curseur au début de la ligne
move_end_of_line : déplacer le curseur à la fin de la ligne
move_previous_char : déplacer le curseur sur le caractère précédent
move_next_char : déplacer le curseur sur le caractère suivant
move_previous_word : déplacer le curseur sur le mot précédent
move_next_word : déplacer le curseur sur le mot suivant
history_previous : rappeler la commande précédente dans l'historique du tampon courant
history_next : rappeler la commande suivante dans l'historique du tampon courant
history_global_previous : rappeler la commande précédente dans l'historique global
history_global_next : rappeler la commande suivante dans l'historique global
jump_smart : sauter au prochain tampon avec de l'activité
jump_last_buffer_displayed : sauter au dernier tampon affiché (avant le dernier saut vers un tampon)
jump_previously_visited_buffer : sauter au tampon visité précédemment
jump_next_visited_buffer : sauter au tampon visité après
hotlist_clear : effacer la hotlist (paramètre facultatif : "lowest" pour effacer seulement le plus petit niveau dans la hotlist, "highest" pour effacer seulement le niveau le plus haut dans la hotlist, ou un masque de niveaux : entier qui est une combinaison de 1=join/part, 2=message, 4=privé, 8=highlight)
grab_key : capturer une touche (paramètre facultatif : délai pour la fin de la capture, par défaut 500 millisecondes)
grab_key_command : capturer une touche avec sa commande associée (paramètre facultatif : délai pour la fin de la capture, par défaut 500 millisecondes)
grab_mouse : capturer un évènement de la souris
grab_mouse_area : capturer un évènement de la souris avec la zone
set_unread : définir le marqueur de données non lues pour tous les tampons
set_unread_current_buffer : définir le marqueur de données non lues pour le tampon courant
switch_active_buffer : basculer vers le tampon mélangé suivant
switch_active_buffer_previous : basculer vers le tampon mélangé précédent
zoom_merged_buffer : zoom sur le tampon mélangé
insert : insérer du texte dans la ligne de commande (les caractères échappés sont autorisés, voir /help print)
send : envoyer du texte au tampon
paste_start : début de collage (mode "bracketed paste")
paste_stop : fin de collage (mode "bracketed paste")
Cette commande est utilisé par les associations de touches ou les extensions.
----
[[command_weechat_key]]
* `+key+`: associer/libérer des touches
----
/key list|listdefault|listdiff [<contexte>]
bind <touche> [<commande> [<args>]]
bindctxt <contexte> <touche> [<commande> [<args>]]
unbind <touche>
unbindctxt <contexte> <touche>
reset <touche>
resetctxt <contexte> <touche>
resetall -yes [<contexte>]
missing [<contexte>]
list : afficher toutes les touches courantes (sans paramètre, cette liste est affichée)
listdefault : afficher les touches par défaut
listdiff : afficher les différences entre les touches courantes et celles par défaut (touches ajoutées, redéfinies ou supprimées)
contexte : nom du contexte ("default" ou "search")
bind : associer une commande à une touche ou affiche la commande associée à la touche
bindctxt : associer une commande à une touche ou affiche la commande associée à la touche pour le contexte donné
commande : commande (plusieurs commandes peuvent êtres séparées par des points-virgules)
unbind : supprimer l'association à une touche
unbindctxt : supprimer l'association à une touche pour le contexte donné
reset : réinitialiser une touche à son association par défaut
resetctxt : réinitialiser une touche à son association par défaut pour le contexte donné
resetall : restaurer les touches aux valeurs par défaut et supprimer TOUTES les touches personnelles (utiliser avec précaution !)
missing : ajouter les touches manquantes (en utilisant les touches par défaut), pratique après installation d'une nouvelle version de WeeChat
Lors de l'association d'une commande à une touche, il est recommandé d'utiliser la touche alt+k (ou Échap puis k), et puis de presser la touche à associer : cela insère le code de la touche dans la ligne de commande.
Pour le contexte "mouse" (possible aussi pour le contexte "cursor"), la touche a le format : "@zone:touche" ou "@zone1>zone2:touche" où la zone peut être :
* : n'importe quelle zone à l'écran
chat : la zone de discussion (n'importe quel tampon)
chat(xxx) : la zone de discussion pour le tampon avec le nom "xxx" (nom complet incluant l'extension)
bar(*) : n'importe quelle barre
bar(xxx) : la barre "xxx"
item(*) : n'importe quel objet de barre
item(xxx) : l'objet de barre "xxx"
La caractère joker "*" est autorisé pour plusieurs évènements de la souris.
Une valeur spéciale pour la commande avec le format "hsignal:nom" peut être utilisée dans le contexte "mouse", cela enverra le signal "nom" avec la table de hachage du focus comme paramètre.
Une autre valeur spéciale "-" peut être utilisée pour désactiver la touche (elle sera ignorée lors de la recherche de touches).
Exemples :
touche alt-t pour activer/désactiver la liste des pseudos :
/key bind meta-t /bar toggle nicklist
touche alt-r pour aller sur le canal IRC #weechat :
/key bind meta-r /buffer #weechat
restaure l'association par défaut pour la touche alt-r :
/key reset meta-r
touche "tab" pour arrêter la recherche dans le tampon :
/key bindctxt search ctrl-I /input search_stop
bouton du milieu de la souris sur un pseudo pour récupérer les infos sur le pseudo :
/key bindctxt mouse @item(buffer_nicklist):button3 /msg nickserv info ${nick}
----
[[command_weechat_layout]]
* `+layout+`: gestion des dispositions de tampons/fenêtres
----
/layout store [<nom>] [buffers|windows]
apply [<nom>] [buffers|windows]
leave
del [<nom>] [buffers|windows]
rename <nom> <nouveau_nom>
store : stocker les tampons/fenêtres courants dans une disposition
apply : appliquer une disposition stockée
leave : quitter la disposition courante (ne met à jour aucune disposition)
del : supprimer les tampons et/ou fenêtres dans une disposition stockée
(si ni "buffers" ni "windows" n'est donné après le nom, la disposition est supprimée)
rename : renommer une disposition
nom : nom pour la disposition stockée (par défaut "default")
buffers : stocker/appliquer seulement pour les tampons (ordre des tampons)
windows : stocker/appliquer seulement pour les fenêtres (le tampon affiché par chaque fenêtre)
Sans paramètre, cette commande affiche les dispositions stockées.
La disposition courante peut être sauvegardée sur la commande /quit avec l'option "weechat.look.save_layout_on_exit".
Note : la disposition se souvient seulement de la division des fenêtres et des numéros de tampons. Elle n'ouvre pas les tampons. Cela signifie par exemple que vous devez toujours automatiquement rejoindre les canaux IRC pour ouvrir les tampons, la disposition sauvée ne s'applique qu'une fois les tampons ouverts.
----
[[command_weechat_mouse]]
* `+mouse+`: contrôle de la souris
----
/mouse enable|disable|toggle [<délai>]
enable : activer la souris
disable : désactiver la souris
toggle : activer/désactiver la souris
délai : délai (en secondes) après lequel l'état initial de la souris est restauré (pratique pour désactiver temporairement la souris)
L'état de la souris est sauvé dans l'option "weechat.look.mouse".
Exemples :
activer la souris :
/mouse enable
activer/désactiver la souris pendant 5 secondes :
/mouse toggle 5
----
[[command_weechat_mute]]
* `+mute+`: exécuter une commande silencieusement
----
/mute [-core | -current | -buffer <nom>] <commande>
-core : pas d'affichage sur le tampon core WeeChat
-current : pas d'affichage sur le tampon courant
-buffer : pas d'affichage sur le tampon spécifié
nom : nom complet du tampon (exemples : "irc.server.libera", "irc.libera.#weechat")
commande : commande à exécuter silencieusement (un '/' est automatiquement ajouté s'il n'est pas trouvé au début de la commande)
Si aucune cible n'est spécifiée (-core, -current ou -buffer), alors par défaut tous les tampons seront silencieux.
Exemples :
sauvegarde configuration :
/mute save
message au canal IRC courant :
/mute -current msg * bonjour !
message au canal #weechat :
/mute -buffer irc.libera.#weechat msg #weechat bonjour !
----
[[command_weechat_plugin]]
* `+plugin+`: lister/charger/décharger des extensions
----
/plugin list|listfull [<nom>]
load <fichier> [<paramètres>]
autoload [<paramètres>]
reload [<nom>|* [<paramètres]]
unload [<nom>]
list : lister les extensions chargées
listfull : lister les extensions chargées (verbeux)
load : charger une extension
autoload : charger automatiquement les extensions dans un répertoire système ou utilisateur
reload : recharger une extension (si pas de nom donné, décharger toutes les extensions, puis recharger automatiquement les extensions)
unload : décharger une extension (si pas de nom donné, décharger toutes les extensions)
fichier : extension (fichier) à charger
nom : nom d'extension
paramètres : paramètres donnés à l'extension lors de son chargement
Sans paramètre, cette commande liste les extensions chargées.
----
[[command_weechat_print]]
* `+print+`: afficher du texte dans un tampon
----
/print [-buffer <numéro>|<nom>] [-newbuffer <nom>] [-free] [-switch] [-core|-current] [-y <ligne>] [-escape] [-date <date>] [-tags <étiquettes>] [-action|-error|-join|-network|-quit] [<texte>]
-stdout|-stderr [<texte>]
-beep
-buffer : afficher le texte dans ce tampon (par défaut : tampon où est exécutée la commande)
-newbuffer : créer un nouveau tampon et afficher le texte dans ce tampon
-free : créer un tampon avec contenu libre (avec -newbuffer seulement)
-switch : basculer vers le tampon
-core : alias de "-buffer core.weechat"
-current : afficher le texte dans le tampon courant
-y : afficher sur une ligne personnalisée (pour un tampon avec contenu libre seulement)
ligne : numéro de ligne pour un tampon avec contenu libre (la première ligne est 0, un nombre négatif affiche après la dernière ligne : -1 = après la dernière ligne, -2 = deux lignes après la dernière ligne, etc.)
-escape : interpréter les caractères échappés (par exemple \a, \07, \x07)
-date : date du message, le format peut être :
-n : 'n' secondes avant maintenant
+n : 'n' secondes dans le futur
n : 'n' secondes depuis l'époque (voir man time)
date/heure (ISO 8601) : yyyy-mm-ddThh:mm:ss, exemple : 2014-01-19T04:32:55
heure : hh:mm:ss (exemple : 04:32:55)
-tags : liste d'étiquettes séparées par des virgules (voir /help filter pour une liste des étiquettes couramment utilisées)
texte : texte à afficher (le préfixe et le message doivent être séparés par "\t", si le texte commence par "-", ajoutez "\" avant)
-stdout : afficher le texte sur stdout (les caractères échappés sont interprétés)
-stderr : afficher le texte sur stderr (les caractères échappés sont interprétés)
-beep : alias de "-stderr \a"
Les options -action ... -quit utilisent le préfixe défini dans les options "weechat.look.prefix_*".
Les caractères échappés suivants sont supportés :
\" \\ \a \b \e \f \n \r \t \v \0ooo \xhh \uhhhh \Uhhhhhhhh
Exemples :
afficher un pense-bête sur le tampon core avec un highlight :
/print -core -tags notify_highlight Pense-bête : acheter du lait
afficher une erreur sur le tampon core :
/print -core -error Une erreur ici
afficher un message sur le tampon core avec le préfixe "abc" :
/print -core abc\tLe message
afficher un message sur le canal #weechat :
/print -buffer irc.libera.#weechat Message sur #weechat
afficher un bonhomme de neige (U+2603) :
/print -escape \u2603
envoyer une alerte (BEL) :
/print -beep
----
[[command_weechat_proxy]]
* `+proxy+`: gestion des proxies
----
/proxy list
add <nom> <type> <adresse> <port> [<utilisateur> [<mot_de_passe>]]
del <nom>|-all
set <nom> <option> <valeur>
list : lister tous les proxies
add : ajouter un nouveau proxy
nom : nom du proxy (doit être unique)
type : http, socks4 ou socks5
adresse : IP ou nom de machine
port : port
utilisateur : nom d'utilisateur (optionnel)
mot_de_passe : mot de passe (optionnel)
del : supprimer un proxy (ou tous les proxies avec -all)
set : changer la valeur d'une propriété d'un proxy
option : option à modifier (pour la liste des options, voir /set weechat.proxy.<proxyname>.*)
valeur : nouvelle valeur pour l'option
Exemples :
ajouter un proxy http, tournant en local, port 8888 :
/proxy add local http 127.0.0.1 8888
ajouter un proxy http en utilisant le protocole IPv6 :
/proxy add local http ::1 8888
/proxy set local ipv6 on
ajouter un proxy socks5 avec un utilisateur/mot de passe :
/proxy add myproxy socks5 sample.host.org 3128 myuser mypass
supprimer un proxy :
/proxy del myproxy
----
[[command_weechat_quit]]
* `+quit+`: quitter WeeChat
----
/quit [-yes] [<paramètres>]
-yes : requis si l'option "weechat.look.confirm_quit" est activée
paramètres : texte envoyé avec le signal "quit"
(par exemple l'extension irc utilise ce texte pour envoyer le message de quit au serveur)
Par défaut en quittant les fichiers de configuration sont sauvegardés (voir l'option "weechat.look.save_config_on_exit") et la disposition courante peut être sauvegardée (voir l'option "weechat.look.save_layout_on_exit").
----
[[command_weechat_reload]]
* `+reload+`: recharger les fichiers de configuration depuis le disque
----
/reload [<fichier> [<fichier>...]]
fichier : fichier de configuration à recharger (sans l'extension ".conf")
Sans paramètre, tous les fichiers (WeeChat et extensions) sont rechargés.
----
[[command_weechat_repeat]]
* `+repeat+`: exécuter une commande plusieurs fois
----
/repeat [-interval <délai>[<unité>]] <nombre> <commande>
délai : délai entre l'exécution des commandes
unité : optionnelle, valeurs possibles :
ms : millisecondes
s : secondes (par défaut)
m : minutes
h : heures
nombre : nombre de fois que la commande sera exécutée
commande : commande à exécuter (ou texte à envoyer au tampon si la commande ne commence pas par '/')
Note : la commande est exécutée sur le tampon où /repeat a été exécuté (si le tampon n'existe plus, la commande n'est pas exécutée).
Exemple :
faire défiler de 2 pages vers le haut :
/repeat 2 /window page_up
----
[[command_weechat_save]]
* `+save+`: sauvegarder les fichiers de configuration sur disque
----
/save [<fichier> [<fichier>...]]
fichier : fichier de configuration à sauvegarder (sans l'extension ".conf")
Sans paramètre, tous les fichiers (WeeChat et extensions) sont sauvegardés.
Par défaut tous les fichiers de configuration sont sauvegardés sur disque sur la commande /quit (voir l'option "weechat.look.save_config_on_exit").
----
[[command_weechat_secure]]
* `+secure+`: gestion des données sécurisées (mots de passe ou données privées chiffrés dans le fichier sec.conf)
----
/secure passphrase <phrase de chiffrement>|-delete
decrypt <phrase de chiffrement>|-discard
set <nom> <valeur>
del <nom>
passphrase : modifier la phrase de chiffrement (sans phrase de chiffrement, les données sont stockées en texte brut dans le fichier sec.conf)
-delete : supprimer la phrase de chiffrement
decrypt : déchiffrer les données toujours chiffrées
-discard : jeter toutes les données encore chiffrées
set : ajouter ou modifier une donnée sécurisée
del : supprimer une donnée sécurisée
Sans paramètre, cette commande affiche les données sécurisées dans un nouveau tampon.
Les touches sur le tampon des données sécurisées :
alt+v afficher/cacher les valeurs
Lorsqu'une phrase de chiffrement est utilisée (données chiffrées), elle est demandée au démarrage de WeeChat.
Il est possible de définir la variable d'environnement WEECHAT_PASSPHRASE pour éviter la demande (cette même variable est utilisée par WeeChat sur le /upgrade) ou de définir l'option sec.crypt.passphrase_command pour lire la phrase de chiffrement depuis la sortie d'une commande externe comme un coffre-fort à mots de passe (voir /help sec.crypt.passphrase_command).
Les données sécurisées avec le format ${sec.data.xxx} peuvent être utilisées dans :
- la commande /eval
- le paramètre de ligne de commande "--run-command"
- les options weechat.startup.command_{before|after}_plugins
- d'autres options qui peuvent contenir un mot de passe ou des données sensibles (par exemple proxy, serveur irc et relay) ; voir /help sur les options pour vérifier si elles sont évaluées.
Exemples :
définir une phrase de chiffrement :
/secure passphrase ceci est ma phrase de chiffrement
utiliser le programme "pass" pour lire la phrase de chiffrement au démarrage :
/set sec.crypt.passphrase_command "/usr/bin/pass show weechat/passphrase"
chiffrer le mot de passe libera SASL :
/secure set libera motdepasse
/set irc.server.libera.sasl_password "${sec.data.libera}"
chiffrer le mot de passe oftc pour nickserv :
/secure set oftc motdepasse
/set irc.server.oftc.command "/msg nickserv identify ${sec.data.oftc}"
alias pour ghost du pseudo "pseudo" :
/alias add ghost /eval /msg -server libera nickserv ghost pseudo ${sec.data.libera}
----
[[command_weechat_set]]
* `+set+`: définir des options de configuration et des variables d'environnement
----
/set [<option> [<valeur>]]
diff [<option> [<option>...]]
env [<variable> [<valeur>]]
option : nom d'une option (le caractère joker "*" est autorisé pour lister les options, si aucune valeur n'est spécifiée)
valeur : nouvelle valeur pour l'option, selon le type :
booléen : on, off ou toggle
entier : nombre, ++nombre ou --nombre
chaîne : toute chaîne ("" pour une chaîne vide)
couleur : nom de couleur, ++nombre ou --nombre
Note : pour tous les types, vous pouvez utiliser null pour supprimer la valeur de l'option (valeur non définie). Cela ne fonctionne qu'avec certaines options spéciales des extensions.
diff : afficher seulement les options modifiées
env : afficher ou définir une variable d'environnement (utilisez la valeur "" pour supprimer une variable)
Exemples :
afficher les options à propos du highlight :
/set *highlight*
ajouter un mot pour le highlight :
/set weechat.look.highlight "mot"
afficher les options modifiées :
/set diff
afficher les options modifiées dans l'extension irc :
/set diff irc.*
afficher la valeur de la variable d'environnement LANG :
/set env LANG
modifier la variable d'environnement LANG et l'utiliser :
/set env LANG fr_FR.UTF-8
/upgrade
réinitialiser la variable d'environnement ABC :
/set env ABC ""
----
[[command_weechat_unset]]
* `+unset+`: supprimer/réinitialiser des options de configuration
----
/unset <option>
-mask <option>
option : nom d'une option
-mask : utiliser un masque pour l'option (le caractère joker "*" est autorisé pour réinitialiser plusieurs options, à utiliser avec prudence !)
Selon l'option, elle est réinitialisée (pour les options standards) ou supprimée (pour les options facultatives, comme les valeurs pour les serveurs).
Exemples :
réinitialiser une option :
/unset weechat.look.item_time_format
réinitialiser toutes les options de couleur :
/unset -mask weechat.color.*
----
[[command_weechat_upgrade]]
* `+upgrade+`: relancer le binaire WeeChat sans se déconnecter des serveurs
----
/upgrade [-yes] [<chemin_vers_binaire>|-quit]
-yes : requis si l'option "weechat.look.confirm_upgrade" est activée
chemin_vers_binaire : chemin vers le binaire WeeChat (par défaut le binaire courant)
-dummy : ne rien faire (option utilisée pour éviter une complétion accidentelle avec "-quit")
-quit : fermer *TOUTES* les connexions, sauver la session et quitter, ce qui rend possible une restauration différée (voir ci-dessous)
Cette commande met à jour et recharge une session de WeeChat qui tourne. Le nouveau binaire WeeChat doit avoir été compilé ou installé via un gestionnaire de paquet avant de lancer cette commande.
Note : les connexions SSL sont perdues durant la mise à jour, car le rechargement de session SSL n'est pas possible actuellement avec GnuTLS. Il y a une reconnexion automatique après la mise à jour.
Le processus de mise à jour comporte 4 étapes :
1. sauvegarder la session pour le cœur et les extensions (tampons, historique, ...)
2. décharger toutes les extensions (les fichiers de configuration (*.conf) sont écrits sur disque)
3. sauvegarder la configuration WeeChat (weechat.conf)
4. exécuter le nouveau binaire WeeChat et recharger la session.
Avec l'option "-quit", le processus est légèrement différent :
1. fermer *TOUTES* les connexions
2. sauvegarder la session (fichiers *.upgrade)
3. décharger les extensions
4. sauvegarder la configuration WeeChat
5. quitter WeeChat
Et plus tard vous pouvez restaurer la session avec la commande : weechat --upgrade
IMPORTANT : vous devez restaurer la session avec exactement la même configuration (fichiers *.conf).
Il est également possible de restaurer la session WeeChat sur une autre machine si vous y copiez le contenu des répertoires personnels de WeeChat (voir /debug dirs).
----
[[command_weechat_uptime]]
* `+uptime+`: montrer la durée de fonctionnement de WeeChat
----
/uptime [-o|-ol]
-o : envoyer la durée de fonctionnement sur le tampon courant comme entrée (chaîne en anglais)
-ol : envoyer la durée de fonctionnement sur le tampon courant comme entrée (chaîne traduite)
----
[[command_weechat_version]]
* `+version+`: afficher la version de WeeChat et la date de compilation
----
/version [-o|-ol]
-o : envoyer la version sur le tampon courant comme entrée (chaîne en anglais)
-ol : envoyer la version sur le tampon courant comme entrée (chaîne traduite)
L'alias par défaut /v peut être utilisé pour exécuter cette commande sur tous les tampons (sinon la commande irc /version est utilisée sur les tampons irc).
----
[[command_weechat_wait]]
* `+wait+`: planifier l'exécution d'une commande dans le futur
----
/wait <nombre>[<unité>] <commande>
nombre : temps à attendre (nombre entier)
unité : optionnelle, valeurs possibles :
ms : millisecondes
s : secondes (par défaut)
m : minutes
h : heures
commande : commande à exécuter (ou texte à envoyer au tampon si la commande ne commence pas par '/')
Note : la commande est exécutée sur le tampon où /wait a été exécuté (si le tampon n'existe plus, la commande n'est pas exécutée).
Exemples :
rejoindre le canal dans 10 secondes :
/wait 10 /join #test
passer absent dans 15 minutes :
/wait 15m /away -all I'm away
dire 'bonjour' dans 2 minutes :
/wait 2m bonjour
----
[[command_weechat_window]]
* `+window+`: gestion des fenêtres
----
/window list
-1|+1|b#|up|down|left|right [-window <numéro>]
<numéro>
splith|splitv [-window <numéro>] [<pct>]
resize [-window <numéro>] [h|v][+|-]<pct>
balance
merge [-window <numéro>] [all]
close [-window <numéro>]
page_up|page_down [-window <numéro>]
refresh
scroll [-window <numéro>] [+|-]<valeur>[s|m|h|d|M|y]
scroll_horiz [-window <numéro>] [+|-]<valeur>[%]
scroll_up|scroll_down|scroll_top|scroll_bottom|scroll_beyond_end|scroll_previous_highlight|scroll_next_highlight|scroll_unread [-window <numéro>]
swap [-window <numéro>] [up|down|left|right]
zoom [-window <numéro>]
bare [<délai>]
list : lister les fenêtres ouvertes (sans paramètre, cette liste est affichée)
-1 : sauter à la fenêtre précédente
+1 : sauter à la fenêtre suivante
b# : sauter à la fenêtre affichant le tampon #
up : sauter à la fenêtre au dessus
down : sauter à la fenêtre au dessous
left : sauter à la fenêtre à gauche
right : sauter à la fenêtre à droite
numéro : numéro de fenêtre (voir /window list)
splith : éclater la fenêtre en deux horizontalement (pour défaire : /window merge)
splitv : éclater la fenêtre en deux verticalement (pour défaire : /window merge)
resize : redimensionner une fenêtre, la nouvelle taille est <pct> pourcentage de la fenêtre parente
si "h" ou "v" est spécifié, le redimensionnement affecte la fenêtre parente la plus proche avec un découpage de ce type (horizontal/vertical)
balance : équilibrer la taille de toutes les fenêtres
merge : fusionner la fenêtre avec une autre
close : fermer la fenêtre
page_up : faire défiler d'une page vers le haut
page_down : faire défiler d'une page vers le bas
refresh : redessiner l'écran
scroll : faire défiler d'un nombre de lignes (+/-N) ou avec du temps : s=secondes, m=minutes, h=heures, d=jours, M=mois, y=année
scroll_horiz : faire défiler horizontalement d'un nombre de colonnes (+/-N) ou un pourcentage de la taille de fenêtre (ce défilement est possible seulement sur les tampons avec contenu libre)
scroll_up : faire défiler de quelques lignes vers le haut
scroll_down : faire défiler de quelques lignes vers le bas
scroll_top : faire défiler jusqu'au début du tampon
scroll_bottom : faire défiler jusqu'en bas du tampon
scroll_beyond_end : faire défiler au-delà de la fin du tampon
scroll_previous_highlight : faire défiler jusqu'au highlight précédent
scroll_next_highlight : faire défiler jusqu'au highlight suivant
scroll_unread : faire défiler jusqu'au marqueur de données non lues
swap : échanger les tampons de deux fenêtres (avec une direction facultative pour la fenêtre cible)
zoom : zoomer sur la fenêtre
bare : activer/désactiver le mode d'affichage dépouillé (avec un délai facultatif en secondes pour un retour automatique au mode d'affichage standard)
Pour splith et splitv, pct est un pourcentage qui représente la taille de la nouvelle fenêtre, calculée par rapport à la taille de la fenêtre courante. Par exemple 25 signifie créer une fenêtre qui a pour taille : taille_courante / 4
Exemples :
sauter à la fenêtre affichant le tampon 1 :
/window b1
défilement de 2 lignes vers le haut :
/window scroll -2
défilement de 2 jours vers le haut :
/window scroll -2d
défilement jusqu'au début du jour courant :
/window scroll -d
zoom sur la fenêtre numéro 2 :
/window zoom -window 2
éclater la fenêtre horizontalement en utilisant 30% de l'espace pour la fenêtre du haut :
/window splith 30
redimensionner la fenêtre à 75% de la taille de la fenêtre parente :
/window resize 75
redimensionner le découpage vertical, ajouter 10% dans la taille :
/window resize v+10
supprimer l'éclatement, garder la fenêtre courante :
/window merge
fermer la fenêtre courante :
/window close
activer le mode d'affichage dépouillé pendant 2 secondes :
/window bare 2
----
// end::weechat_commands[]
// tag::buflist_commands[]
[[command_buflist_buflist]]
* `+buflist+`: objet de barre avec la liste des tampons
----
/buflist enable|disable|toggle
bar
refresh
enable : activer buflist
disable : désactiver buflist
toggle : activer/désactiver buflist
bar : ajouter la barre "buflist"
refresh : forcer le rafraichissement des objets de barre (buflist, buflist2 et buflist3)
Les lignes avec les tampons sont affichées en utilisant l'évaluation de chaînes (voir /help eval pour le format), avec ces options :
- buflist.look.display_conditions : conditions pour afficher un tampon dans la liste
- buflist.format.buffer : format pour un tampon qui n'est pas le tampon courant
- buflist.format.buffer_current: format pour le tampon courant
Les variables suivantes peuvent être utilisées dans ces options :
- données de l'objet de barre (voir le hdata "bar_item" dans la doc API pour une liste complète), par exemple :
- ${bar_item.name}
- données de la fenêtre ("window"), où l'objet de barre est affiché (il n'y a pas de fenêtre pour les barres de type "root", voir le hdata "window" dans la doc API pour une liste complète), par exemple :
- ${window.number}
- ${window.buffer.full_name}
- données du tampon (voir le hdata "buffer" dans la doc API pour une liste complète), par exemple :
- ${buffer.number}
- ${buffer.name}
- ${buffer.full_name}
- ${buffer.short_name}
- ${buffer.nicklist_nicks_count}
- irc_server: données du serveur IRC, défini seulement sur un tampon IRC (voir le hdata "irc_server" dans la doc API)
- irc_channel: données du canal IRC, défini seulement sur un tampon de canal IRC (voir le hdata "irc_channel" dans la doc API)
- variables additionnelles ajoutées par buflist pour des raisons pratiques :
- ${format_buffer} : la valeur évaluée de l'option buflist.format.buffer ; peut être utilisée dans l'option buflist.format.buffer_current pour juste changer la couleur de fond par exemple
- ${current_buffer} : un booléen ("0" ou "1"), "1" s'il s'agit du tampon courant ; cela peut être utilisé dans une condition : ${if:${current_buffer}?...:...}
- ${merged} : un booléen ("0" ou "1"), "1" si le tampon est mélangé avec au moins un autre tampon ; cela peut être utilisé dans une condition : ${if:${merged}?...:...}
- ${format_number} : numéro indenté avec un séparateur (évaluation de l'option buflist.format.number)
- ${number} : numéro indenté, par exemple " 1" s'il y a entre 10 et 99 tampons ; pour les tampons mélangés, cette variable est définie avec le numéro pour le premier tampon et des espaces pour les tampons suivants avec le même numéro
- ${number2} : numéro indenté, par exemple " 1" s'il y a entre 10 et 99 tampons
- ${number_displayed} : "1" si le numéro est affiché, sinon "0"
- ${indent} : indentation pour le nom (les tampons de canaux ou privés sont indentés) (évaluation de l'option buflist.format.indent)
- ${format_nick_prefix} : le préfixe du pseudo en couleur pour un canal (évaluation de l'option buflist.format.nick_prefix)
- ${color_nick_prefix} : la couleur du préfixe du pseudo pour un canal (défini seulement si l'option buflist.look.nick_prefix est activée)
- ${nick_prefix} : le préfixe du pseudo pour un canal (défini seulement si l'option buflist.look.nick_prefix est activée)
- ${format_name} : le nom formaté (évaluation de l'option buflist.format.name)
- ${name} : le nom court (si défini), sinon le nom
- ${color_hotlist} : la couleur qui dépend du niveau de hotlist le plus élevé pour le tampon (évaluation de l'option buflist.format.hotlist_xxx où xxx est le niveau)
- ${format_hotlist} : la hotlist formatée (évaluation de l'option buflist.format.hotlist)
- ${hotlist} : la hotlist brute
- ${hotlist_priority} : "none", "low", "message", "private" ou "highlight"
- ${format_lag} : le lag pour un tampon de serveur IRC, vide s'il n'y a pas de lag (évaluation de l'option buflist.format.lag)
- ${format_tls_version}: indicateur de la version de TLS pour le serveur courant, vide pour les canaux (évaluation de l'option buflist.format.tls_version)
----
// end::buflist_commands[]
// tag::charset_commands[]
[[command_charset_charset]]
* `+charset+`: changer le charset pour le tampon courant
----
/charset decode|encode <charset>
reset
decode : changer le charset de décodage
encode : changer le charset d'encodage
charset : nouveau charset pour le tampon courant
reset : réinitialiser les charsets pour le tampon courant
----
// end::charset_commands[]
// tag::exec_commands[]
[[command_exec_exec]]
* `+exec+`: exécuter des commandes externes
----
/exec -list
[-sh|-nosh] [-bg|-nobg] [-stdin|-nostdin] [-buffer <nom>] [-l|-o|-oc|-n|-nf] [-oerr] [-cl|-nocl] [-sw|-nosw] [-ln|-noln] |-flush|-noflush] [-color ansi|auto|irc|weechat|strip] [-rc|-norc] [-timeout <délai>] [-name <nom>] [-pipe <commande>] [-hsignal <nom>] <commande>
-in <id> <texte>
-inclose <id> [<texte>]
-signal <id> <signal>
-kill <id>
-killall
-set <id> <propriété> <valeur>
-del <id>|-all [<id>...]
-list : lister les commandes
-sh : utiliser le shell pour exécuter la commande, plusieurs commandes peuvent être enchaînées avec des pipes (ATTENTION : utilisez cette option SEULEMENT si tous les paramètres sont fiables, voir l'option -nosh)
-nosh : ne pas utiliser le shell pour exécuter la commande (requis si la commande a des données non fiables, par exemple le contenu d'un message d'un autre utilisateur) (par défaut)
-bg : lancer le processus en tâche de fond : ne pas afficher la sortie ni le code retour (non compatible avec les options -o/-oc/-n/-nf/-pipe/-hsignal)
-nobg : capturer la sortie du processus et afficher le code retour (par défaut)
-stdin : créer un tuyau pour envoyer des données sur l'entrée standard du processus (avec /exec -in/-inclose)
-nostdin : ne pas créer de tuyau pour l'entrée standard (par défaut)
-buffer : afficher/envoyer la sortie de la commande sur ce tampon (si le tampon n'est pas trouvé, un nouveau tampon avec le nom "exec.exec.xxx" est créé)
-l : afficher localement la sortie de la commande sur le tampon (par défaut)
-o : envoyer la sortie de la commande au tampon sans exécuter les commandes (non compatible avec les options -bg/-pipe/-hsignal)
-oc : envoyer la sortie de la commande au tampon et exécuter les commandes (lignes commençant par "/" ou un caractère personnalisé de commande) (non compatible avec les options -bg/-pipe/-hsignal)
-n : afficher la sortie de la commande dans un nouveau tampon (non compatible avec les options -bg/-pipe/-hsignal)
-nf : afficher la sortie de la commande dans un nouveau tampon avec contenu libre (pas de coupure des mots, pas de limite sur le nombre de lignes) (non compatible avec les options -bg/-pipe/-hsignal)
-oerr : envoyer aussi stderr (sortie d'erreur) au tampon (peut être utilisé seulement avec les options -o et -oc)
-cl : effacer le nouveau tampon avant d'afficher la sortie
-nocl : ajouter au nouveau tampon sans effacer (par défaut)
-sw : basculer vers le tampon de sortie (par défaut)
-nosw : ne pas basculer vers le tampon de sortie
-ln : afficher les numéros de ligne (par défaut dans un nouveau tampon seulement)
-noln : ne pas afficher les numéros de ligne
-flush : afficher la sortie de la commande en temps réel (par défaut)
-noflush : afficher la sortie de la commande une fois qu'elle est terminée
-color : action sur les couleurs ANSI dans la sortie :
ansi : garder les codes ANSI tels quels
auto : convertir les couleurs ANSI en couleurs WeeChat/IRC (par défaut)
irc : convertir les couleurs ANSI en couleurs IRC
weechat : convertir les couleurs ANSI en couleurs WeeChat
strip : supprimer les couleurs ANSI
-rc : afficher le code retour (par défaut)
-norc : ne pas afficher le code retour
-timeout : définir un délai maximum pour la commande (en secondes)
-name : définir un nom pour la commande (pour la nommer plus tard avec /exec)
-pipe : envoyer la sortie vers une commande WeeChat/extension (ligne par ligne) ; s'il y a des espaces dans la commande/paramètres, entourez les de guillemets ; la variable $line est remplacée par la ligne (par défaut la ligne est ajoutée après la commande, séparée par un espace) (non compatible avec les options -bg/-o/-oc/-n/-nf)
-hsignal : envoyer la sortie sous forme de hsignal (pour être utilisé par exemple dans un trigger) (non compatible avec les options -bg/-o/-oc/-n/-nf)
commande : la commande à exécuter ; si elle commence par "url:", le shell est désactivé et le contenu de l'URL est téléchargé et envoyé comme sortie
id : identifiant de commande : soit le numéro ou le nom (si défini avec "-name xxx")
-in : envoyer le texte sur l'entrée standard du processus
-inclose : identique à -in, mais l'entrée standard est fermée après (et le texte est facultatif : sans texte, l'entrée standard est juste fermée)
-signal : envoyer un signal au processus ; le signal peut être un entier ou l'un de ces noms : hup, int, quit, kill, term, usr1, usr2
-kill : alias de "-signal <id> kill"
-killall : tuer tous les processus
-set : définir une propriété du hook (voir la fonction hook_set dans l'API de référence extension)
propriété : propriété du hook
valeur : nouvelle valeur pour la propriété du hook
-del : supprimer la commande terminée
-all : supprimer toutes les commandes terminées
Les options par défaut peuvent être définies dans l'option exec.command.default_options.
Exemples :
/exec -n ls -l /tmp
/exec -sh -n ps xu | grep weechat
/exec -n -norc url:https://pastebin.com/raw.php?i=xxxxxxxx
/exec -nf -noln links -dump https://weechat.org/files/doc/devel/weechat_user.en.html
/exec -o uptime
/exec -pipe "/print Durée de fonctionnement de la machine :" uptime
/exec -n tail -f /var/log/messages
/exec -kill 0
----
// end::exec_commands[]
// tag::fifo_commands[]
[[command_fifo_fifo]]
* `+fifo+`: configuration de l'extension fifo
----
/fifo enable|disable|toggle
enable : activer le tube FIFO
disable : désactiver le tube FIFO
toggle : activer/désactiver le tube FIFO
Le tube FIFO est utilisé comme contrôle à distance de WeeChat : vous pouvez envoyer des commandes ou du texte au tube FIFO depuis votre shell.
Par défaut le tube FIFO se nomme weechat_fifo_xxx (où xxx est l'id du processus WeeChat) et situé dans le répertoire "runtime" de WeeChat (voir /debug dirs).
Le format attendu est l'un des suivants :
plugin.buffer *texte ou commande ici
*texte ou commande ici
Par exemple pour changer votre pseudo sur libera :
echo 'irc.server.libera */nick autrepseudo' >/run/user/1000/weechat/weechat_fifo_12345
Merci de lire le guide utilisateur pour plus d'information et des exemples.
Exemples :
/fifo toggle
----
// end::fifo_commands[]
// tag::fset_commands[]
[[command_fset_fset]]
* `+fset+`: définir rapidement des options WeeChat et des extensions
----
/fset -bar
-refresh
-up|-down [<nombre>]
-left|-right [<pourcentage>]
-go <ligne>|end
-toggle
-add [<valeur>]
-reset
-unset
-set
-setnew
-append
-mark
-format
-export [-help|-nohelp] <fichier>
<filtre>
-bar : ajouter la barre d'aide
-refresh : rafraîchir la liste des options, puis l'écran entier (commande : /window refresh)
-up : déplacer la ligne sélectionnée de "nombre" lignes vers le haut
-down : déplacer la ligne sélectionnée de "nombre" lignes vers le bas
-left : faire défier le tampon fset de "pourcentage" de largeur vers la gauche
-right : faire défier le tampon fset de "pourcentage" de largeur vers la droite
-go : sélectionner une ligne par numéro, la première ligne est 0 ("end" pour sélectionner la dernière ligne)
-toggle : basculer la valeur booléenne
-add : ajouter "valeur" (qui peut être un nombre négatif) pour les entiers et couleurs, définir/ajouter à la valeur pour les autres types (définir pour une valeur négative, ajouter pour un nombre positif)
-reset : réinitialiser la valeur de l'option
-unset : supprimer/réinitialiser l'option
-set : ajouter la commande /set dans l'entrée pour éditer la valeur de l'option (déplacer le curseur au début de la valeur)
-setnew : ajouter la commande /set dans l'entrée pour éditer une nouvelle valeur pour l'option
-append : ajouter la commande /set pour ajouter quelque chose dans la valeur de l'option (déplacer le curseur à la fin de la valeur)
-mark : marquer/démarquer
-format : basculer vers le prochain format disponible
-export : exporter les options et valeurs affichées dans un fichier (chaque ligne a le format : "/set nom valeur" ou "/unset nom")
-help : forcer l'écriture de l'aide sur les options dans le fichier exporté (voir /help fset.look.export_help_default)
-nohelp : ne pas écrire l'aide sur les options dans le fichier exporté (voir /help fset.look.export_help_default)
filtre : définir un nouveau filtre pour voir seulement les options correspondantes (ce filtre peut aussi être utilisé en entrée du tampon fset) ; les formats autorisés sont :
* afficher toutes les options (pas de filtre)
xxx afficher seulement les options avec "xxx" dans le nom
f:xxx afficher seulement le fichier de configuration "xxx"
t:xxx afficher seulement le type "xxx" (bool/int/str/col)
d afficher seulement les options changées
d:xxx afficher seulement les options changées avec "xxx" dans le nom
d=xxx afficher seulement les options changées avec "xxx" dans la valeur
d==xxx afficher seulement les options changées avec la valeur exacte "xxx"
h=xxx afficher seulement les options avec "xxx" dans la description (traduite)
he=xxx afficher seulement les options avec "xxx" dans la description (en Anglais)
=xxx afficher seulement les options avec "xxx" dans la valeur
==xxx afficher seulement les options avec la valeur exacte "xxx"
c:xxx afficher seulement les options qui correspondent à la condition évaluée "xxx", en utilisant les variables suivantes : file, section, option, name, parent_name, type, type_en, type_short (bool/int/str/col), type_tiny (b/i/s/c), default_value, default_value_undef, value, quoted_value, value_undef, value_changed, parent_value, min, max, description, description2, description_en, description_en2, string_values
Les lignes avec des options sont affichées en utilisant l'évaluation de chaîne (voir /help eval pour le format), avec ces options :
- fset.format.option1 : premier format pour une option
- fset.format.option2 : second format pour une option
Les variables suivantes peuvent être utilisées dans ces options :
- données de l'option, avec couleur et alignées avec des espaces sur la droite :
- ${file} : fichier de configuration (par exemple "weechat" ou "irc")
- ${section} : section
- ${option} : nom de l'option
- ${name} : nom complet de l'option (fichier.section.option)
- ${parent_name} : nom de l'option parente
- ${type} : type de l'option (traduit)
- ${type_en} : type de l'option (en Anglais)
- ${type_short} : type court de l'option (bool/int/str/col)
- ${type_tiny} : type très court de l'option (b/i/s/c)
- ${default_value} : valeur par défaut de l'option
- ${default_value_undef} : "1" si la valeur par défaut est null, sinon "0"
- ${value} : valeur de l'option
- ${value_undef} : "1" si la valer est null, sinon "0"
- ${value_changed} : "1" si la valeur est différente de la valeur par défaut, sinon "0"
- ${value2} : valeur de l'option, avec la valeur héritée si null
- ${parent_value} : valeur de l'option parente
- ${min} : valeur minimale
- ${max} : valeur maximale
- ${description} : description de l'option (traduite)
- ${description2} : description de l'option (traduite), "(pas de description)" s'il n'y a pas de description
- ${description_en} : description de l'option (en Anglais)
- ${description_en2} : description de l'option (en Anglais), "(no description)" s'il n'y a pas de description
- ${string_values} : valeurs chaîne autorisées pour définir une option de type entier utilisant des chaînes
- ${marked} : "1" si l'option est marquée, sinon "0"
- ${index} : index de l'option dans la liste
- données de l'option, avec couleur mais sans espaces :
- mêmes noms préfixés par un underscore, par exemple : ${_name}, ${_type}, ...
- données de l'option, format brut (par de couleurs/espaces) :
- mêmes noms préfixés par deux underscores, par exemple : ${__name}, ${__type}, ...
- données de l'option, seulement des espaces :
- mêmes noms préfixés par "empty_", par exemple : ${empty_name}, ${empty_type}
- autres données :
- ${selected_line} : "1" si la ligne est sélectionnée, sinon "0"
- ${newline} : insérer une nouvelle ligne à cet endroit, pour afficher l'option sur plusieurs lignes
Touches et entrées pour le déplacement dans le tampon fset :
haut se déplacer d'une ligne vers le haut
bas se déplacer d'une ligne vers le bas
pgup se déplacer d'une page vers le haut
pgdn se déplacer d'une page vers le bas
alt-home << se déplacer à la première ligne
alt-end >> se déplacer à la dernière ligne
F11 < faire défiler horizontalement vers la gauche
F12 > faire défiler horizontalement vers la droite
Touches et entrées pour définir les options sur le tampon fset :
alt+espace t basculer la valeur booléenne
alt+'-' - soustraire 1 de la valeur pour un entier/couleur, définir la valeur pour les autres types
alt+'+' + ajouter 1 à la valeur pour un entier/couleur, ajouter à la valeur pour les autres types
alt+f, alt+r r réinitialiser la valeur
alt+f, alt+u u supprimer/réinitialiser la valeur
alt+entrée s définir la valeur
alt+f, alt+n n définir une nouvelle valeur
alt+f, alt+a a ajouter à la valeur
alt+',' , marquer/démarquer l'option
shift+haut se déplacer d'une ligne vers le haut et marquer/démarquer l'option
shift+bas marquer/démarquer l'option et se déplacer d'une ligne vers le bas
m:xxx marquer les options affichées qui correspondent au filtre "xxx" (tout filtre sur une option ou valeur est autorisé, voir les filtres ci-dessus)
u:xxx démarquer les options affichées qui correspondent au filtre "xxx" (tout filtre sur une option ou valeur est autorisé, voir les filtres ci-dessus)
Autres touches et entrées sur le tampon fset :
ctrl+L rafraîchir les options et l'écran entier (commande : /fset -refresh)
$ rafraîchir les options (garder les options marquées)
$$ rafraîchir les options (démarquer toutes les options)
alt+p p activer/désactiver la description des options d'extensions (plugins.desc.*)
alt+v v activer/désactiver la barre d'aide
s:x,y trier les options par les champs x,y (voir /help fset.look.sort)
s: réinitialiser le tri à sa valeur par défaut (voir /help fset.look.sort)
w:xxx exporter les options dans le fichier "xxx"
w-:xxx exporter les options dans le fichier "xxx" sans aide
w+:xxx exporter les options dans le fichier "xxx" avec aide
ctrl+X x basculer le format utilisé pour afficher les options
q fermer le tampon fset
Actions de la souris sur le tampon fset :
roulette haut/bas se déplacer vers le haut/bas
bouton gauche se déplacer à cette ligne
bouton droit basculer le booléen (on/off) ou éditer la valeur de l'option
bouton droit + glisser gauche/droite incrémenter/décrémenter la valeur pour un entier/couleur, définir/ajouter à la valeur pour les autres types
bouton droit + glisser haut/bas marquer/démarquer plusieurs options
Note : si l'entrée comporte un ou plusieurs espaces en tête, le texte suivant est interprété comme un filtre, sans les espaces. Par exemple " q" cherche toutes les options avec "q" dans le nom, tandis que "q" ferme le tampon fset.
Exemples :
afficher les options IRC changées :
/fset d:irc.*
afficher les options avec "nicklist" dans le nom :
/fset nicklist
afficher les valeurs qui contiennent "red" :
/fset =red
afficher les valeurs qui sont exactement "red" :
/fset ==red
afficher toutes les options de type "entier" dans l'extension irc :
/fset c:${file} == irc && ${type_en} == integer
----
// end::fset_commands[]
// tag::guile_commands[]
[[command_guile_guile]]
* `+guile+`: lister/charger/décharger des scripts
----
/guile list|listfull [<nom>]
load [-q] <fichier>
autoload
reload|unload [-q] [<nom>]
eval [-o|-oc] <code>
version
list : lister les scripts chargés
listfull : lister les scripts chargés (verbeux)
load : charger un script
autoload : charger tous les scripts dans le répertoire "autoload"
reload : recharger un script (si pas de nom donné, décharger tous les scripts puis charger tous les scripts dans le répertoire "autoload")
unload : décharger un script (si pas de nom donné, décharger tous les scripts)
fichier : script (fichier) à charger
-q : mode silencieux : ne pas afficher de messages
nom : nom de script (nom utilisé dans l'appel à la fonction "register")
eval : évaluer le code source et afficher le résultat sur le tampon courant
-o : envoyer le résultat de l'évaluation au tampon sans exécuter les commandes
-oc : envoyer le résultat de l'évaluation au tampon et exécuter les commandes
code : le code source à évaluer
version : afficher la version de l'interpréteur utilisé
Sans paramètre, cette commande liste les scripts chargés.
----
// end::guile_commands[]
// tag::javascript_commands[]
[[command_javascript_javascript]]
* `+javascript+`: lister/charger/décharger des scripts
----
/javascript list|listfull [<nom>]
load [-q] <fichier>
autoload
reload|unload [-q] [<nom>]
eval [-o|-oc] <code>
version
list : lister les scripts chargés
listfull : lister les scripts chargés (verbeux)
load : charger un script
autoload : charger tous les scripts dans le répertoire "autoload"
reload : recharger un script (si pas de nom donné, décharger tous les scripts puis charger tous les scripts dans le répertoire "autoload")
unload : décharger un script (si pas de nom donné, décharger tous les scripts)
fichier : script (fichier) à charger
-q : mode silencieux : ne pas afficher de messages
nom : nom de script (nom utilisé dans l'appel à la fonction "register")
eval : évaluer le code source et afficher le résultat sur le tampon courant
-o : envoyer le résultat de l'évaluation au tampon sans exécuter les commandes
-oc : envoyer le résultat de l'évaluation au tampon et exécuter les commandes
code : le code source à évaluer
version : afficher la version de l'interpréteur utilisé
Sans paramètre, cette commande liste les scripts chargés.
----
// end::javascript_commands[]
// tag::logger_commands[]
[[command_logger_logger]]
* `+logger+`: configuration de l'extension logger
----
/logger list
set <niveau>
flush
disable
list : afficher le statut d'enregistrement pour les tampons ouverts
set : définir le niveau d'enregistrement pour le tampon courant
niveau : niveau pour les messages à enregistrer (0 = pas d'enregistrement, 1 = quelques messages (les plus importants) .. 9 = tous les messages)
flush : écrire tous les fichiers de log maintenant
disable : désactiver l'enregistrement pour le tampon courant (définir le niveau à 0)
Les options "logger.level.*" et "logger.mask.*" peuvent être utilisées pour définir le niveau ou le masque de nom de fichier pour un tampon, ou plusieurs tampons commençant par un nom.
Niveaux de log utilisés par l'extension IRC :
1 : message d'utilisateur (canal et privé), notice (serveur et canal)
2 : changement de pseudo
3 : message du serveur
4 : join/part/quit
9 : tous les autres messages
Exemples :
définir le niveau d'enregistrement à 5 pour le tampon courant :
/logger set 5
désactiver l'enregistrement pour le tampon courant :
/logger disable
définir le niveau à 3 pour les tampons IRC :
/set logger.level.irc 3
désactiver l'enregistrement pour le tampon principal de WeeChat :
/set logger.level.core.weechat 0
utiliser un répertoire par serveur IRC et un fichier par canal dedans :
/set logger.mask.irc "$server/$channel.weechatlog"
----
// end::logger_commands[]
// tag::lua_commands[]
[[command_lua_lua]]
* `+lua+`: lister/charger/décharger des scripts
----
/lua list|listfull [<nom>]
load [-q] <fichier>
autoload
reload|unload [-q] [<nom>]
eval [-o|-oc] <code>
version
list : lister les scripts chargés
listfull : lister les scripts chargés (verbeux)
load : charger un script
autoload : charger tous les scripts dans le répertoire "autoload"
reload : recharger un script (si pas de nom donné, décharger tous les scripts puis charger tous les scripts dans le répertoire "autoload")
unload : décharger un script (si pas de nom donné, décharger tous les scripts)
fichier : script (fichier) à charger
-q : mode silencieux : ne pas afficher de messages
nom : nom de script (nom utilisé dans l'appel à la fonction "register")
eval : évaluer le code source et afficher le résultat sur le tampon courant
-o : envoyer le résultat de l'évaluation au tampon sans exécuter les commandes
-oc : envoyer le résultat de l'évaluation au tampon et exécuter les commandes
code : le code source à évaluer
version : afficher la version de l'interpréteur utilisé
Sans paramètre, cette commande liste les scripts chargés.
----
// end::lua_commands[]
// tag::xfer_commands[]
[[command_xfer_me]]
* `+me+`: envoyer une action CTCP à l'hôte distant
----
/me <message>
message : message à envoyer
----
[[command_xfer_xfer]]
* `+xfer+`: contrôle xfer
----
/xfer [list|listfull]
list : lister les xfer
listfull : lister les xfer (verbeux)
Sans paramètre, cette commande ouvre le tampon avec la liste des xfer.
----
// end::xfer_commands[]
// tag::perl_commands[]
[[command_perl_perl]]
* `+perl+`: lister/charger/décharger des scripts
----
/perl list|listfull [<nom>]
load [-q] <fichier>
autoload
reload|unload [-q] [<nom>]
eval [-o|-oc] <code>
version
list : lister les scripts chargés
listfull : lister les scripts chargés (verbeux)
load : charger un script
autoload : charger tous les scripts dans le répertoire "autoload"
reload : recharger un script (si pas de nom donné, décharger tous les scripts puis charger tous les scripts dans le répertoire "autoload")
unload : décharger un script (si pas de nom donné, décharger tous les scripts)
fichier : script (fichier) à charger
-q : mode silencieux : ne pas afficher de messages
nom : nom de script (nom utilisé dans l'appel à la fonction "register")
eval : évaluer le code source et afficher le résultat sur le tampon courant
-o : envoyer le résultat de l'évaluation au tampon sans exécuter les commandes
-oc : envoyer le résultat de l'évaluation au tampon et exécuter les commandes
code : le code source à évaluer
version : afficher la version de l'interpréteur utilisé
Sans paramètre, cette commande liste les scripts chargés.
----
// end::perl_commands[]
// tag::php_commands[]
[[command_php_php]]
* `+php+`: lister/charger/décharger des scripts
----
/php list|listfull [<nom>]
load [-q] <fichier>
autoload
reload|unload [-q] [<nom>]
eval [-o|-oc] <code>
version
list : lister les scripts chargés
listfull : lister les scripts chargés (verbeux)
load : charger un script
autoload : charger tous les scripts dans le répertoire "autoload"
reload : recharger un script (si pas de nom donné, décharger tous les scripts puis charger tous les scripts dans le répertoire "autoload")
unload : décharger un script (si pas de nom donné, décharger tous les scripts)
fichier : script (fichier) à charger
-q : mode silencieux : ne pas afficher de messages
nom : nom de script (nom utilisé dans l'appel à la fonction "register")
eval : évaluer le code source et afficher le résultat sur le tampon courant
-o : envoyer le résultat de l'évaluation au tampon sans exécuter les commandes
-oc : envoyer le résultat de l'évaluation au tampon et exécuter les commandes
code : le code source à évaluer
version : afficher la version de l'interpréteur utilisé
Sans paramètre, cette commande liste les scripts chargés.
----
// end::php_commands[]
// tag::python_commands[]
[[command_python_python]]
* `+python+`: lister/charger/décharger des scripts
----
/python list|listfull [<nom>]
load [-q] <fichier>
autoload
reload|unload [-q] [<nom>]
eval [-o|-oc] <code>
version
list : lister les scripts chargés
listfull : lister les scripts chargés (verbeux)
load : charger un script
autoload : charger tous les scripts dans le répertoire "autoload"
reload : recharger un script (si pas de nom donné, décharger tous les scripts puis charger tous les scripts dans le répertoire "autoload")
unload : décharger un script (si pas de nom donné, décharger tous les scripts)
fichier : script (fichier) à charger
-q : mode silencieux : ne pas afficher de messages
nom : nom de script (nom utilisé dans l'appel à la fonction "register")
eval : évaluer le code source et afficher le résultat sur le tampon courant
-o : envoyer le résultat de l'évaluation au tampon sans exécuter les commandes
-oc : envoyer le résultat de l'évaluation au tampon et exécuter les commandes
code : le code source à évaluer
version : afficher la version de l'interpréteur utilisé
Sans paramètre, cette commande liste les scripts chargés.
----
// end::python_commands[]
// tag::relay_commands[]
[[command_relay_relay]]
* `+relay+`: contrôle du relai
----
/relay list|listfull|listrelay
add <nom> <port>|<chemin>
del|start|restart|stop <nom>
raw
sslcertkey
list : lister les clients pour le relai
listfull : lister les clients pour le relai (verbeux)
listrelay : lister les relais (nom et port)
add : ajouter un relai (écouter sur un port)
del : supprimer un relai (les clients restent connectés)
start : écouter sur le port
restart : fermer le socket serveur et écouter à nouveau sur le port (les clients restent connectés)
stop : fermer le socket serveur (les clients restent connectés)
nom : nom du relai (voir le format ci-dessous)
port : port utilisé pour le relai
chemin : chemin utilisé pour le relai (pour un socket de domaine UNIX seulement) ; le chemin est évalué (voir la fonction string_eval_path_home dans la référence API extension)
raw : ouvrir le tampon avec les données brutes Relay
sslcertkey : définir le certificat/clé SSL en utilisant le chemin de l'option relay.network.ssl_cert_key
Le nom du relai est : [ipv4.][ipv6.][ssl.]<protocole.nom> ou unix[.ssl].<protocole.nom>
ipv4 : forcer l'utilisation d'IPv4
ipv6 : forcer l'utilisation d'IPv6
ssl : activer SSL
unix : utiliser un socket de domaine UNIX
protocole.nom : protocole et nom à relayer :
- protocole "irc" : le nom est le serveur à partager (optionnel, si non donné, le nom de serveur doit être envoyé par le client dans la commande "PASS", avec le format : "PASS serveur:motdepasse")
- protocole "weechat" (le nom n'est pas utilisé)
Le protocole "irc" permet à n'importe quel client IRC (incluant WeeChat lui-même) de se connecter sur le port.
Le protocole "weechat" permet à une interface distante de se connecter sur le port, voir la liste ici : https://weechat.org/about/interfaces
Sans paramètre, cette commande ouvre le tampon avec la liste des clients pour le relai.
Exemples :
proxy irc, pour le serveur "libera" :
/relay add irc.libera 8000
proxy irc, pour le serveur "libera", avec SSL :
/relay add ssl.irc.libera 8001
proxy irc, pour tous les serveurs (le client choisira), avec SSL :
/relay add ssl.irc 8002
protocole weechat :
/relay add weechat 9000
protocole weechat avec SSL :
/relay add ssl.weechat 9001
protocole weechat avec SSL, en utilisant seulement IPv4 :
/relay add ipv4.ssl.weechat 9001
protocole weechat avec SSL, en utilisant seulement IPv6 :
/relay add ipv6.ssl.weechat 9001
protocole weechat avec SSL, en utilisant IPv4 + IPv6 :
/relay add ipv4.ipv6.ssl.weechat 9001
protocole weechat avec un socket de domaine UNIX :
/relay add unix.weechat ${weechat_runtime_dir}/relay_socket
----
// end::relay_commands[]
// tag::ruby_commands[]
[[command_ruby_ruby]]
* `+ruby+`: lister/charger/décharger des scripts
----
/ruby list|listfull [<nom>]
load [-q] <fichier>
autoload
reload|unload [-q] [<nom>]
eval [-o|-oc] <code>
version
list : lister les scripts chargés
listfull : lister les scripts chargés (verbeux)
load : charger un script
autoload : charger tous les scripts dans le répertoire "autoload"
reload : recharger un script (si pas de nom donné, décharger tous les scripts puis charger tous les scripts dans le répertoire "autoload")
unload : décharger un script (si pas de nom donné, décharger tous les scripts)
fichier : script (fichier) à charger
-q : mode silencieux : ne pas afficher de messages
nom : nom de script (nom utilisé dans l'appel à la fonction "register")
eval : évaluer le code source et afficher le résultat sur le tampon courant
-o : envoyer le résultat de l'évaluation au tampon sans exécuter les commandes
-oc : envoyer le résultat de l'évaluation au tampon et exécuter les commandes
code : le code source à évaluer
version : afficher la version de l'interpréteur utilisé
Sans paramètre, cette commande liste les scripts chargés.
----
// end::ruby_commands[]
// tag::script_commands[]
[[command_script_script]]
* `+script+`: Gestionnaire de scripts WeeChat
----
/script list [-o|-ol|-i|-il]
search <texte>
show <script>
load|unload|reload <script> [<script>...]
autoload|noautoload|toggleautoload <script> [<script>...]
install|remove|installremove|hold [-q] <script> [<script>...]
upgrade
update
list : lister les scripts chargés (tous les langages)
-o : envoyer la liste des scripts chargés au tampon (chaîne en anglais)
-ol : envoyer la liste des scripts chargés au tampon (chaîne traduite)
-i : copier la liste des scripts chargés dans la ligne de commande (pour envoi au tampon) (chaîne en anglais)
-il : copier la liste des scripts chargés dans la ligne de commande (pour envoi au tampon) (chaîne traduite)
search : chercher des scripts par étiquettes, langage (python, perl, ...), extension de fichier (py, pl, ...) ou texte ; le résultat est affiché sur le tampon des scripts
show : afficher des infos détaillées sur le script
load : charger un ou plusieurs scripts
unload : décharger un ou plusieurs scripts
reload : recharger un ou plusieurs scripts
autoload : charger automatiquement un ou plusieurs scripts
noautoload : ne pas charger automatiquement un ou plusieurs scripts
toggleautoload : activer/désactiver le chargement automatique
install : installer/mettre à jour un ou plusieurs scripts
remove : supprimer un ou plusieurs scripts
installremove : installer ou supprimer un ou plusieurs scripts, selon l'état courant
hold : figer/défiger un ou plusieurs scripts (un script figé ne sera plus mis à jour et ne peut pas être supprimé)
-q : mode silencieux : ne pas afficher de messages
upgrade : mettre à jour les scripts obsolètes (avec nouvelle version disponible)
update : mettre à jour le cache local des scripts
Sans paramètre, cette commande ouvre un tampon avec la liste des scripts.
Sur le tampon des scripts, les statuts pour chaque script sont :
* i a H r N
| | | | | |
| | | | | obsolète (nouvelle version disponible)
| | | | chargé
| | | figé
| | chargé auto
| installé
script populaire
Dans la sortie de /script list, les statuts pour chaque script sont :
* ? i a H N
| | | | | |
| | | | | obsolète (nouvelle version disponible)
| | | | figé
| | | chargé auto
| | installé
| script inconnu (ne peut pas être téléchargé/mis à jour)
script populaire
Les touches sur le tampon des scripts :
alt+i installer le script
alt+r supprimer le script
alt+l charger le script
alt+L recharger le script
alt+u décharger le script
alt+A chargement automatique du script
alt+h (dé)figer le script
alt+v voir le script
Entrée autorisée sur le tampon des scripts :
i/r/l/L/u/A/h/v action sur le script (identique aux touches ci-dessus)
q fermer le tampon
$ rafraîchir le tampon
s:x,y trier le tampon en utilisant les clés x et y (voir /help script.look.sort)
s: réinitialiser le tri (utiliser le tri par défaut)
word(s) filtrer les scripts : recherche du/des mot(s) dans les scripts (description, étiquettes, ...)
* supprimer le filtre
Actions de la souris sur le tampon des scripts :
roulette faire défiler la liste
bouton gauche sélectionner le script
bouton droit installer/supprimer le script
Exemples :
/script search url
/script install go.py urlserver.py
/script remove go.py
/script hold urlserver.py
/script reload urlserver
/script upgrade
----
// end::script_commands[]
// tag::spell_commands[]
[[command_spell_spell]]
* `+spell+`: configuration de l'extension spell
----
/spell enable|disable|toggle
listdict
setdict <dict>[,<dict>...]
deldict
addword [<dict>] <mot>
enable : activer le vérificateur d'orthographe
disable : désactiver le vérificateur d'orthographe
toggle : activer/désactiver le vérificateur d'orthographe
listdict : afficher les dictionnaires installés
setdict : définir le dictionnaire pour le tampon courant (plusieurs dictionnaires peuvent être séparés par une virgule)
deldict : supprimer le dictionnaire utilisé sur le tampon courant
addword : ajouter un mot dans le dictionnaire personnel
Les lignes d'entrée commençant par '/' ne sont pas vérifiées, sauf pour certaines commandes (voir /set spell.check.commands).
Pour activer le vérificateur d'orthographe sur tous les tampons, utilisez l'option "default_dict", par exemple :
/set spell.check.default_dict "en"
/spell enable
Pour afficher une liste des suggestions dans une barre, utilisez l'objet "spell_suggest".
La touche par défaut pour activer/désactiver le vérificateur d'orthographe est alt-s.
----
// end::spell_commands[]
// tag::tcl_commands[]
[[command_tcl_tcl]]
* `+tcl+`: lister/charger/décharger des scripts
----
/tcl list|listfull [<nom>]
load [-q] <fichier>
autoload
reload|unload [-q] [<nom>]
eval [-o|-oc] <code>
version
list : lister les scripts chargés
listfull : lister les scripts chargés (verbeux)
load : charger un script
autoload : charger tous les scripts dans le répertoire "autoload"
reload : recharger un script (si pas de nom donné, décharger tous les scripts puis charger tous les scripts dans le répertoire "autoload")
unload : décharger un script (si pas de nom donné, décharger tous les scripts)
fichier : script (fichier) à charger
-q : mode silencieux : ne pas afficher de messages
nom : nom de script (nom utilisé dans l'appel à la fonction "register")
eval : évaluer le code source et afficher le résultat sur le tampon courant
-o : envoyer le résultat de l'évaluation au tampon sans exécuter les commandes
-oc : envoyer le résultat de l'évaluation au tampon et exécuter les commandes
code : le code source à évaluer
version : afficher la version de l'interpréteur utilisé
Sans paramètre, cette commande liste les scripts chargés.
----
// end::tcl_commands[]
// tag::trigger_commands[]
[[command_trigger_trigger]]
* `+trigger+`: gestion des triggers, le couteau Suisse pour WeeChat
----
/trigger list|listfull|listdefault
add|addoff|addreplace <nom> <hook> ["<paramètres>" ["<conditions>" ["<regex>" ["<commande>" ["<code_retour>" ["action_post"]]]]]]
addinput [<hook>]
input|output|recreate <nom>
set <nom> <option> <valeur>
rename|copy <nom> <nouveau_nom>
enable|disable|toggle [<nom>|-all [<nom>...]]
restart <nom>|-all [<nom>...]
show <nom>
del <nom>|-all [<nom>...]
restore <nom> [<nom>...]
default -yes
monitor [<filtre>]
list : lister les triggers (sans paramètre, cette liste est affichée)
listfull : lister les triggers avec des informations détaillées pour chaque trigger
listdefault : lister les triggers par défaut
add : ajouter un trigger
addoff : ajouter un trigger (désactivé)
addreplace : ajouter ou remplacer un trigger existant
nom : nom du trigger
hook : signal, hsignal, modifier, line, print, command, command_run, timer, config, focus, info, info_hashtable
paramètres : paramètres pour le hook, dépendant du hook (séparés par des points-virgules) :
signal : nom(s) de signal (obligatoire)
hsignal : nom(s) de signal (obligatoire)
modifier : nom(s) de modificateur (obligatoire)
line : type de tampon ("formatted", "free" ou "*"), liste de masques de tampons, étiquettes
print : tampon, étiquettes, message, suppression des couleurs (0/1)
command : commande (obligatoire), description, paramètres, description des paramètres, complétion (tous les paramètres sauf la commande sont évalués, "${tg_trigger_name}" est remplacé par le nom du trigger, voir /help eval)
command_run : commande(s) (obligatoire)
timer : intervalle (obligatoire), alignement sur la seconde, nombre max d'appels
config : nom(s) de l'option (obligatoire)
focus : nom(s) de la zone (obligatoire)
info : nom(s) de l'info (obligatoire)
info_hashtable : nom(s) de l'info (obligatoire)
conditions : conditions évaluées pour le trigger
regex : une ou plusieurs expressions régulières pour remplacer des chaînes dans les variables
commande : commande à exécuter (plusieurs commandes peuvent être séparées par ";")
code_retour : code retour dans la fonction de rappel (ok (par défaut), ok_eat, error)
action_post : action à effectuer après l'exécution (none (par défaut), disable, delete)
addinput : définir la ligne de commande avec les paramètres par défaut pour créer un trigger
input : définir la ligne de commande utilisée pour créer le trigger
output : envoyer la commande pour créer le trigger sur le tampon
recreate : comme "input", avec l'option "addreplace" au lieu de "add"
set : définir une option dans un trigger
option : nom de l'option : name, hook, arguments, conditions, regex, command, return_code
(pour l'aide sur l'option, vous pouvez taper : /help trigger.trigger.<nom>.<option>)
valeur : nouvelle valeur pour l'option
rename : renommer un trigger
copy : copier un trigger
enable : activer un/des trigger(s) (sans paramètre : activer les triggers globalement)
disable : désactiver un/des trigger(s) (sans paramètre : désactiver les triggers globalement)
toggle : activer/désactiver un/des trigger(s) (sans paramètre : activer/désactiver les triggers globalement)
restart : redémarrer un/des trigger(s) (recréer les hooks)
show : afficher des informations détaillées sur un trigger (avec quelques statistiques)
del : supprimer un trigger
-all : effectuer l'action sur tous les triggers
restore : restaurer un/des trigger(s) avec les valeurs par défaut (fonctionne seulement pour les triggers par défaut)
default : restaurer les triggers par défaut
monitor : ouvrir le tampon moniteur des triggers
filtre : filtrer les hooks/triggers à afficher (un hook doit commencer par "@", par exemple "@signal"), plusieurs filtres peuvent être séparés par des virgules ; le caractère joker "*" est autorisé dans chaque nom de trigger
Lorsqu'une fonction de rappel de trigger est appelée, les actions suivantes sont exécutées, dans cet ordre :
1. vérifier les conditions ; si faux, sortir
2. remplacer le texte en utilisant une/des expression(s)s régulière(s)s POSIX étendue(s)s (si définie(s) dans le trigger)
3. exécuter le(s) commande(s) (si définie(s) dans le trigger)
4. sortir avec le code retour (sauf pour les modificateurs, line, focus, info et info_hashtable)
5. effectuer l'action "post"
Exemples (vous pouvez aussi regarder les triggers par défaut avec /trigger listdefault) :
ajouter des attributs *gras*, _souligné_ et /italique/ (seulement dans les messages d'utilisateurs) :
/trigger add effects modifier weechat_print "${tg_tag_nick}" "==\*([^ ]+)\*==*${color:bold}${re:1}${color:-bold}*== ==_([^ ]+)_==_${color:underline}${re:1}${color:-underline}_== ==/([^ ]+)/==/${color:italic}${re:1}${color:-italic}/"
cacher la barre de pseudos sur les petits terminaux :
/trigger add resize_small signal signal_sigwinch "${info:term_width} < 100" "" "/bar hide nicklist"
/trigger add resize_big signal signal_sigwinch "${info:term_width} >= 100" "" "/bar show nicklist"
sauver la configuration chaque heure (de manière silencieuse) :
/trigger add cfgsave timer 3600000;0;0 "" "" "/mute /save"
ouvrir le tampon moniteur des triggers et afficher seulement les modificateurs et les triggers dont le nom commence par "resize" :
/trigger monitor @modifier,resize*
----
// end::trigger_commands[]
|