qutebrowser_commands.html 163 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825282628272828282928302831283228332834283528362837283828392840284128422843284428452846284728482849285028512852285328542855285628572858285928602861286228632864286528662867286828692870287128722873287428752876287728782879288028812882288328842885288628872888288928902891289228932894289528962897289828992900290129022903290429052906290729082909291029112912291329142915291629172918291929202921292229232924292529262927292829292930293129322933293429352936293729382939294029412942294329442945294629472948294929502951295229532954295529562957295829592960296129622963296429652966296729682969297029712972297329742975297629772978297929802981298229832984298529862987298829892990299129922993299429952996299729982999300030013002300330043005300630073008300930103011301230133014301530163017301830193020302130223023302430253026302730283029303030313032303330343035303630373038303930403041304230433044304530463047304830493050305130523053305430553056305730583059306030613062306330643065306630673068306930703071307230733074307530763077307830793080308130823083308430853086308730883089309030913092309330943095309630973098309931003101310231033104310531063107310831093110311131123113311431153116311731183119312031213122312331243125312631273128312931303131313231333134313531363137313831393140314131423143314431453146314731483149315031513152315331543155315631573158315931603161316231633164316531663167316831693170317131723173317431753176317731783179318031813182318331843185318631873188318931903191319231933194319531963197319831993200320132023203320432053206320732083209321032113212321332143215321632173218321932203221322232233224322532263227322832293230323132323233323432353236323732383239324032413242324332443245324632473248324932503251325232533254325532563257325832593260326132623263326432653266326732683269327032713272327332743275327632773278327932803281328232833284328532863287328832893290329132923293329432953296329732983299330033013302330333043305330633073308330933103311331233133314331533163317331833193320332133223323332433253326332733283329333033313332333333343335333633373338333933403341334233433344334533463347334833493350335133523353335433553356335733583359336033613362336333643365336633673368336933703371337233733374337533763377337833793380338133823383338433853386338733883389339033913392339333943395339633973398339934003401340234033404340534063407340834093410341134123413341434153416341734183419342034213422342334243425342634273428342934303431343234333434343534363437343834393440344134423443344434453446344734483449345034513452345334543455345634573458345934603461346234633464346534663467346834693470347134723473347434753476347734783479348034813482348334843485348634873488348934903491349234933494349534963497349834993500350135023503350435053506350735083509351035113512351335143515351635173518351935203521352235233524352535263527352835293530353135323533353435353536353735383539354035413542354335443545354635473548354935503551355235533554355535563557355835593560356135623563356435653566356735683569357035713572357335743575357635773578357935803581358235833584358535863587358835893590359135923593359435953596359735983599360036013602360336043605360636073608360936103611361236133614361536163617361836193620362136223623362436253626362736283629363036313632363336343635363636373638363936403641364236433644364536463647364836493650365136523653365436553656365736583659366036613662366336643665366636673668366936703671367236733674367536763677367836793680368136823683368436853686368736883689369036913692369336943695369636973698369937003701370237033704370537063707370837093710371137123713371437153716371737183719372037213722372337243725372637273728372937303731373237333734373537363737373837393740374137423743374437453746374737483749375037513752375337543755375637573758375937603761376237633764376537663767376837693770377137723773377437753776377737783779378037813782378337843785378637873788378937903791379237933794379537963797379837993800380138023803380438053806380738083809381038113812381338143815381638173818381938203821382238233824382538263827382838293830383138323833383438353836383738383839384038413842384338443845384638473848384938503851385238533854385538563857385838593860386138623863386438653866386738683869387038713872387338743875387638773878387938803881388238833884388538863887388838893890389138923893389438953896389738983899390039013902390339043905390639073908390939103911391239133914391539163917391839193920392139223923392439253926392739283929393039313932393339343935393639373938393939403941394239433944394539463947394839493950395139523953395439553956395739583959396039613962396339643965396639673968396939703971397239733974397539763977397839793980398139823983398439853986398739883989399039913992399339943995399639973998399940004001400240034004400540064007400840094010401140124013401440154016401740184019402040214022402340244025402640274028402940304031403240334034403540364037403840394040404140424043404440454046404740484049405040514052405340544055405640574058405940604061406240634064406540664067406840694070407140724073407440754076407740784079408040814082408340844085408640874088408940904091409240934094409540964097409840994100410141024103410441054106410741084109411041114112411341144115411641174118411941204121412241234124412541264127412841294130413141324133413441354136413741384139414041414142414341444145414641474148414941504151415241534154415541564157415841594160416141624163416441654166416741684169417041714172417341744175417641774178417941804181418241834184418541864187418841894190419141924193419441954196419741984199420042014202420342044205420642074208420942104211421242134214421542164217421842194220422142224223422442254226422742284229423042314232423342344235423642374238423942404241424242434244424542464247424842494250425142524253425442554256425742584259426042614262426342644265426642674268426942704271427242734274427542764277427842794280428142824283428442854286428742884289429042914292429342944295429642974298429943004301430243034304430543064307430843094310431143124313431443154316431743184319432043214322432343244325432643274328432943304331433243334334433543364337433843394340434143424343434443454346434743484349435043514352435343544355435643574358435943604361436243634364436543664367436843694370437143724373437443754376437743784379438043814382438343844385438643874388438943904391439243934394439543964397439843994400440144024403440444054406440744084409441044114412441344144415441644174418441944204421442244234424442544264427442844294430443144324433443444354436443744384439444044414442444344444445444644474448444944504451445244534454445544564457445844594460446144624463446444654466446744684469447044714472447344744475447644774478447944804481448244834484448544864487448844894490449144924493449444954496449744984499450045014502450345044505450645074508450945104511451245134514451545164517451845194520452145224523452445254526452745284529453045314532453345344535453645374538453945404541454245434544454545464547454845494550455145524553455445554556455745584559456045614562456345644565456645674568456945704571457245734574457545764577457845794580458145824583458445854586458745884589459045914592459345944595459645974598459946004601460246034604460546064607460846094610461146124613461446154616461746184619462046214622462346244625462646274628462946304631463246334634463546364637463846394640464146424643464446454646464746484649465046514652465346544655465646574658465946604661466246634664466546664667466846694670467146724673467446754676467746784679468046814682468346844685468646874688468946904691469246934694469546964697469846994700470147024703470447054706470747084709471047114712471347144715471647174718471947204721472247234724472547264727472847294730473147324733473447354736473747384739474047414742474347444745474647474748474947504751475247534754475547564757475847594760476147624763476447654766476747684769477047714772477347744775477647774778477947804781478247834784478547864787478847894790479147924793479447954796479747984799480048014802480348044805480648074808480948104811481248134814481548164817481848194820482148224823482448254826482748284829483048314832483348344835483648374838483948404841484248434844484548464847484848494850485148524853485448554856485748584859486048614862486348644865486648674868486948704871487248734874487548764877487848794880488148824883488448854886488748884889489048914892489348944895489648974898489949004901490249034904490549064907490849094910491149124913491449154916491749184919492049214922492349244925492649274928492949304931493249334934493549364937493849394940494149424943494449454946494749484949495049514952495349544955495649574958495949604961
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
  3. "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
  4. <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
  5. <head>
  6. <meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />
  7. <meta name="generator" content="AsciiDoc 9.0.1" />
  8. <title>qutebrowser</title>
  9. <style type="text/css">
  10. * {
  11. margin: 0px 0px;
  12. padding: 0px 0px;
  13. }
  14. body {
  15. font-family: "Open Sans", "Helvetica Neue", Helvetica, Arial, sans-serif;
  16. -webkit-text-size-adjust: none;
  17. color: #333333;
  18. background-color: #ffffff;
  19. overflow-y: scroll;
  20. }
  21. p {
  22. margin: 6px 0;
  23. }
  24. #preamble > .sectionbody > .paragraph > p {
  25. margin: 0;
  26. }
  27. #header {
  28. display: none;
  29. }
  30. #headline {
  31. background-color: #333333;
  32. padding: 20px 20px;
  33. overflow: auto;
  34. color: #888;
  35. -webkit-user-select: none;
  36. -moz-user-select: none;
  37. -ms-user-select: none;
  38. }
  39. #headline .text {
  40. float: right;
  41. text-align: right;
  42. }
  43. #headline .text .heading-text {
  44. color: #1e89c6;
  45. font-weight: bold;
  46. font-size: 2em;
  47. border: none;
  48. display: block;
  49. white-space: pre-line;
  50. }
  51. #headline .text {
  52. color: #666666;
  53. }
  54. #announcement {
  55. padding: 10px 10px;
  56. background-color: #a6dfff;
  57. margin-bottom: 10px;
  58. }
  59. #menu > #announcement-button {
  60. color: #000000;
  61. background-color: #a6dfff;
  62. }
  63. #menu {
  64. padding: 0px 20px;
  65. background-color: #555555;
  66. color: #CCC;
  67. overflow: auto;
  68. -webkit-user-select: none;
  69. -moz-user-select: none;
  70. -ms-user-select: none;
  71. }
  72. #menu a {
  73. color: #CCC;
  74. text-decoration: none;
  75. background-color: #555555;
  76. padding: 10px 20px;
  77. float: left;
  78. }
  79. #menu a:hover {
  80. background-color: #1e89c6;
  81. }
  82. .sect1,
  83. div.footnote {
  84. padding: 10px 40px;
  85. margin: 0 auto;
  86. max-width: 1200px;
  87. }
  88. #footnotes > hr {
  89. max-width: 1200px;
  90. margin: 20px auto 10px;
  91. width: calc(100% - 80px);
  92. }
  93. .sect2 {
  94. padding: 10px 0px;
  95. }
  96. div.footnote {
  97. padding: 10px 40px 30px;
  98. }
  99. hr {
  100. margin: 0px 40px;
  101. color: #CCCCCC;
  102. }
  103. h1, h2, h3, h4, h5, h6 {
  104. color: #0A396E;
  105. margin-bottom: 10px;
  106. border-bottom: 1px solid #CCCCCC;
  107. }
  108. .ulist {
  109. padding-left: 20px;
  110. margin-top: 10px;
  111. }
  112. #footer {
  113. padding: 20px 40px;
  114. border-top: 1px solid #CCCCCC;
  115. color: #888888;
  116. }
  117. a {
  118. color: #1e89c6;
  119. text-decoration: none;
  120. }
  121. a:hover {
  122. text-decoration: underline;
  123. }
  124. ol {
  125. margin-left: 20px;
  126. margin-top: 20px;
  127. margin-bottom: 20px;
  128. }
  129. li {
  130. margin-bottom: 10px;
  131. }
  132. .hdlist1 {
  133. color: #0A396E;
  134. margin-bottom: 10px;
  135. margin-top: 10px;
  136. border-bottom: 1px solid #CCCCCC;
  137. }
  138. code {
  139. background-color: #DDDDDD;
  140. border-radius: 2px;
  141. }
  142. .listingblock {
  143. padding: 10px 10px;
  144. background-color: #DDDDDD;
  145. border-radius: 4px;
  146. overflow-x: auto;
  147. }
  148. /*Display table as something that is not a table*/
  149. .admonitionblock table,
  150. .admonitionblock tbody,
  151. .admonitionblock tr,
  152. .admonitionblock td {
  153. display: block;
  154. }
  155. .admonitionblock td {
  156. padding: 0;
  157. }
  158. .admonitionblock .title {
  159. color: #0A396E;
  160. font-weight: bold;
  161. }
  162. .admonitionblock td.content {
  163. padding-left: 10px;
  164. border-left: 1px solid #ccc;
  165. }
  166. table td {
  167. padding: 10px 10px;
  168. }
  169. @media screen and (max-width: 480px) {
  170. #headline .text {
  171. display: none;
  172. }
  173. #menu {
  174. padding: 0px 0px;
  175. background-color: #555555;
  176. color: #CCC;
  177. overflow: hidden;
  178. width: 100%;
  179. }
  180. #menu a {
  181. color: #CCC;
  182. text-decoration: none;
  183. background-color: #555555;
  184. width: 100%;
  185. padding: 10px 40px;
  186. }
  187. }
  188. #toc {
  189. margin-bottom: 2.5em;
  190. }
  191. #toctitle {
  192. color: #0A396E;
  193. font-size: 1.1em;
  194. font-weight: bold;
  195. margin-top: 1.0em;
  196. margin-bottom: 0.1em;
  197. }
  198. div.toclevel0, div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
  199. margin-top: 0;
  200. margin-bottom: 0;
  201. }
  202. div.toclevel2 {
  203. margin-left: 2em;
  204. font-size: 0.9em;
  205. }
  206. div.toclevel3 {
  207. margin-left: 4em;
  208. font-size: 0.9em;
  209. }
  210. div.toclevel4 {
  211. margin-left: 6em;
  212. font-size: 0.9em;
  213. }
  214. </style>
  215. <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0" />
  216. <link href="/media/font.css" rel="stylesheet" type="text/css" />
  217. <link rel="icon" href="/media/favicon.png" type="image/png" />
  218. <style type="text/css">
  219. .highlight .hll { background-color: #ffffcc }
  220. .highlight { background: #f8f8f8; }
  221. .highlight .c { color: #408080; font-style: italic } /* Comment */
  222. .highlight .err { border: 1px solid #FF0000 } /* Error */
  223. .highlight .k { color: #008000; font-weight: bold } /* Keyword */
  224. .highlight .o { color: #666666 } /* Operator */
  225. .highlight .cm { color: #408080; font-style: italic } /* Comment.Multiline */
  226. .highlight .cp { color: #BC7A00 } /* Comment.Preproc */
  227. .highlight .c1 { color: #408080; font-style: italic } /* Comment.Single */
  228. .highlight .cs { color: #408080; font-style: italic } /* Comment.Special */
  229. .highlight .gd { color: #A00000 } /* Generic.Deleted */
  230. .highlight .ge { font-style: italic } /* Generic.Emph */
  231. .highlight .gr { color: #FF0000 } /* Generic.Error */
  232. .highlight .gh { color: #000080; font-weight: bold } /* Generic.Heading */
  233. .highlight .gi { color: #00A000 } /* Generic.Inserted */
  234. .highlight .go { color: #808080 } /* Generic.Output */
  235. .highlight .gp { color: #000080; font-weight: bold } /* Generic.Prompt */
  236. .highlight .gs { font-weight: bold } /* Generic.Strong */
  237. .highlight .gu { color: #800080; font-weight: bold } /* Generic.Subheading */
  238. .highlight .gt { color: #0040D0 } /* Generic.Traceback */
  239. .highlight .kc { color: #008000; font-weight: bold } /* Keyword.Constant */
  240. .highlight .kd { color: #008000; font-weight: bold } /* Keyword.Declaration */
  241. .highlight .kn { color: #008000; font-weight: bold } /* Keyword.Namespace */
  242. .highlight .kp { color: #008000 } /* Keyword.Pseudo */
  243. .highlight .kr { color: #008000; font-weight: bold } /* Keyword.Reserved */
  244. .highlight .kt { color: #B00040 } /* Keyword.Type */
  245. .highlight .m { color: #666666 } /* Literal.Number */
  246. .highlight .s { color: #BA2121 } /* Literal.String */
  247. .highlight .na { color: #7D9029 } /* Name.Attribute */
  248. .highlight .nb { color: #008000 } /* Name.Builtin */
  249. .highlight .nc { color: #0000FF; font-weight: bold } /* Name.Class */
  250. .highlight .no { color: #880000 } /* Name.Constant */
  251. .highlight .nd { color: #AA22FF } /* Name.Decorator */
  252. .highlight .ni { color: #999999; font-weight: bold } /* Name.Entity */
  253. .highlight .ne { color: #D2413A; font-weight: bold } /* Name.Exception */
  254. .highlight .nf { color: #0000FF } /* Name.Function */
  255. .highlight .nl { color: #A0A000 } /* Name.Label */
  256. .highlight .nn { color: #0000FF; font-weight: bold } /* Name.Namespace */
  257. .highlight .nt { color: #008000; font-weight: bold } /* Name.Tag */
  258. .highlight .nv { color: #19177C } /* Name.Variable */
  259. .highlight .ow { color: #AA22FF; font-weight: bold } /* Operator.Word */
  260. .highlight .w { color: #bbbbbb } /* Text.Whitespace */
  261. .highlight .mf { color: #666666 } /* Literal.Number.Float */
  262. .highlight .mh { color: #666666 } /* Literal.Number.Hex */
  263. .highlight .mi { color: #666666 } /* Literal.Number.Integer */
  264. .highlight .mo { color: #666666 } /* Literal.Number.Oct */
  265. .highlight .sb { color: #BA2121 } /* Literal.String.Backtick */
  266. .highlight .sc { color: #BA2121 } /* Literal.String.Char */
  267. .highlight .sd { color: #BA2121; font-style: italic } /* Literal.String.Doc */
  268. .highlight .s2 { color: #BA2121 } /* Literal.String.Double */
  269. .highlight .se { color: #BB6622; font-weight: bold } /* Literal.String.Escape */
  270. .highlight .sh { color: #BA2121 } /* Literal.String.Heredoc */
  271. .highlight .si { color: #BB6688; font-weight: bold } /* Literal.String.Interpol */
  272. .highlight .sx { color: #008000 } /* Literal.String.Other */
  273. .highlight .sr { color: #BB6688 } /* Literal.String.Regex */
  274. .highlight .s1 { color: #BA2121 } /* Literal.String.Single */
  275. .highlight .ss { color: #19177C } /* Literal.String.Symbol */
  276. .highlight .bp { color: #008000 } /* Name.Builtin.Pseudo */
  277. .highlight .vc { color: #19177C } /* Name.Variable.Class */
  278. .highlight .vg { color: #19177C } /* Name.Variable.Global */
  279. .highlight .vi { color: #19177C } /* Name.Variable.Instance */
  280. .highlight .il { color: #666666 } /* Literal.Number.Integer.Long */
  281. </style>
  282. <script type="text/javascript">
  283. /*<![CDATA[*/
  284. var asciidoc = { // Namespace.
  285. /////////////////////////////////////////////////////////////////////
  286. // Table Of Contents generator
  287. /////////////////////////////////////////////////////////////////////
  288. /* Author: Mihai Bazon, September 2002
  289. * http://students.infoiasi.ro/~mishoo
  290. *
  291. * Table Of Content generator
  292. * Version: 0.4
  293. *
  294. * Feel free to use this script under the terms of the GNU General Public
  295. * License, as long as you do not remove or alter this notice.
  296. */
  297. /* modified by Troy D. Hanson, September 2006. License: GPL */
  298. /* modified by Stuart Rackham, 2006, 2009. License: GPL */
  299. // toclevels = 1..4.
  300. toc: function (toclevels) {
  301. function getText(el) {
  302. var text = "";
  303. for (var i = el.firstChild; i != null; i = i.nextSibling) {
  304. if (i.nodeType == 3 /* Node.TEXT_NODE */) // IE doesn't speak constants.
  305. text += i.data;
  306. else if (i.firstChild != null)
  307. text += getText(i);
  308. }
  309. return text;
  310. }
  311. function TocEntry(el, text, toclevel) {
  312. this.element = el;
  313. this.text = text;
  314. this.toclevel = toclevel;
  315. }
  316. function tocEntries(el, toclevels) {
  317. var result = new Array;
  318. var re = new RegExp('[hH]([1-'+(toclevels+1)+'])');
  319. // Function that scans the DOM tree for header elements (the DOM2
  320. // nodeIterator API would be a better technique but not supported by all
  321. // browsers).
  322. var iterate = function (el) {
  323. for (var i = el.firstChild; i != null; i = i.nextSibling) {
  324. if (i.nodeType == 1 /* Node.ELEMENT_NODE */) {
  325. var mo = re.exec(i.tagName);
  326. if (mo && (i.getAttribute("class") || i.getAttribute("className")) != "float") {
  327. result[result.length] = new TocEntry(i, getText(i), mo[1]-1);
  328. }
  329. iterate(i);
  330. }
  331. }
  332. }
  333. iterate(el);
  334. return result;
  335. }
  336. var toc = document.getElementById("toc");
  337. if (!toc) {
  338. return;
  339. }
  340. // Delete existing TOC entries in case we're reloading the TOC.
  341. var tocEntriesToRemove = [];
  342. var i;
  343. for (i = 0; i < toc.childNodes.length; i++) {
  344. var entry = toc.childNodes[i];
  345. if (entry.nodeName.toLowerCase() == 'div'
  346. && entry.getAttribute("class")
  347. && entry.getAttribute("class").match(/^toclevel/))
  348. tocEntriesToRemove.push(entry);
  349. }
  350. for (i = 0; i < tocEntriesToRemove.length; i++) {
  351. toc.removeChild(tocEntriesToRemove[i]);
  352. }
  353. // Rebuild TOC entries.
  354. var entries = tocEntries(document.getElementById("content"), toclevels);
  355. for (var i = 0; i < entries.length; ++i) {
  356. var entry = entries[i];
  357. if (entry.element.id == "")
  358. entry.element.id = "_toc_" + i;
  359. var a = document.createElement("a");
  360. a.href = "#" + entry.element.id;
  361. a.appendChild(document.createTextNode(entry.text));
  362. var div = document.createElement("div");
  363. div.appendChild(a);
  364. div.className = "toclevel" + entry.toclevel;
  365. toc.appendChild(div);
  366. }
  367. if (entries.length == 0)
  368. toc.parentNode.removeChild(toc);
  369. },
  370. /////////////////////////////////////////////////////////////////////
  371. // Footnotes generator
  372. /////////////////////////////////////////////////////////////////////
  373. /* Based on footnote generation code from:
  374. * http://www.brandspankingnew.net/archive/2005/07/format_footnote.html
  375. */
  376. footnotes: function () {
  377. // Delete existing footnote entries in case we're reloading the footnodes.
  378. var i;
  379. var noteholder = document.getElementById("footnotes");
  380. if (!noteholder) {
  381. return;
  382. }
  383. var entriesToRemove = [];
  384. for (i = 0; i < noteholder.childNodes.length; i++) {
  385. var entry = noteholder.childNodes[i];
  386. if (entry.nodeName.toLowerCase() == 'div' && entry.getAttribute("class") == "footnote")
  387. entriesToRemove.push(entry);
  388. }
  389. for (i = 0; i < entriesToRemove.length; i++) {
  390. noteholder.removeChild(entriesToRemove[i]);
  391. }
  392. // Rebuild footnote entries.
  393. var cont = document.getElementById("content");
  394. var spans = cont.getElementsByTagName("span");
  395. var refs = {};
  396. var n = 0;
  397. for (i=0; i<spans.length; i++) {
  398. if (spans[i].className == "footnote") {
  399. n++;
  400. var note = spans[i].getAttribute("data-note");
  401. if (!note) {
  402. // Use [\s\S] in place of . so multi-line matches work.
  403. // Because JavaScript has no s (dotall) regex flag.
  404. note = spans[i].innerHTML.match(/\s*\[([\s\S]*)]\s*/)[1];
  405. spans[i].innerHTML =
  406. "[<a id='_footnoteref_" + n + "' href='#_footnote_" + n +
  407. "' title='View footnote' class='footnote'>" + n + "</a>]";
  408. spans[i].setAttribute("data-note", note);
  409. }
  410. noteholder.innerHTML +=
  411. "<div class='footnote' id='_footnote_" + n + "'>" +
  412. "<a href='#_footnoteref_" + n + "' title='Return to text'>" +
  413. n + "</a>. " + note + "</div>";
  414. var id =spans[i].getAttribute("id");
  415. if (id != null) refs["#"+id] = n;
  416. }
  417. }
  418. if (n == 0)
  419. noteholder.parentNode.removeChild(noteholder);
  420. else {
  421. // Process footnoterefs.
  422. for (i=0; i<spans.length; i++) {
  423. if (spans[i].className == "footnoteref") {
  424. var href = spans[i].getElementsByTagName("a")[0].getAttribute("href");
  425. href = href.match(/#.*/)[0]; // Because IE return full URL.
  426. n = refs[href];
  427. spans[i].innerHTML =
  428. "[<a href='#_footnote_" + n +
  429. "' title='View footnote' class='footnote'>" + n + "</a>]";
  430. }
  431. }
  432. }
  433. },
  434. install: function(toclevels) {
  435. var timerId;
  436. function reinstall() {
  437. asciidoc.footnotes();
  438. if (toclevels) {
  439. asciidoc.toc(toclevels);
  440. }
  441. }
  442. function reinstallAndRemoveTimer() {
  443. clearInterval(timerId);
  444. reinstall();
  445. }
  446. timerId = setInterval(reinstall, 500);
  447. if (document.addEventListener)
  448. document.addEventListener("DOMContentLoaded", reinstallAndRemoveTimer, false);
  449. else
  450. window.onload = reinstallAndRemoveTimer;
  451. }
  452. }
  453. asciidoc.install(2);
  454. /*]]>*/
  455. </script>
  456. </head>
  457. <body class="article">
  458. <div id="header">
  459. <h1>qutebrowser</h1>
  460. </div>
  461. <div id="content">
  462. <div id="preamble">
  463. <div class="sectionbody">
  464. <div class="paragraph"><p><div id="headline">
  465. </div>
  466. <div id="announcement">
  467. </div></p></div>
  468. </div>
  469. </div>
  470. <div class="sect1">
  471. <h2 id="_commands">Commands</h2>
  472. <div class="sectionbody">
  473. <div class="paragraph"><p>In qutebrowser, all keybindings are mapped to commands.</p></div>
  474. <div class="paragraph"><p>Some commands are hidden, which means they don&#8217;t show up in the command
  475. completion when pressing <code>:</code>, as they&#8217;re typically not useful to run by hand.</p></div>
  476. <div class="paragraph"><p>For command arguments, there are also some variables you can use:</p></div>
  477. <div class="ulist"><ul>
  478. <li>
  479. <p>
  480. <code>{url}</code> expands to the URL of the current page
  481. </p>
  482. </li>
  483. <li>
  484. <p>
  485. <code>{url:pretty}</code> expands to the URL in decoded format
  486. </p>
  487. </li>
  488. <li>
  489. <p>
  490. <code>{url:host}</code>, <code>{url:domain}</code>, <code>{url:auth}</code>, <code>{url:scheme}</code>, <code>{url:username}</code>,
  491. <code>{url:password}</code>, <code>{url:host}</code>, <code>{url:port}</code>, <code>{url:path}</code> and <code>{url:query}</code>
  492. expand to the respective parts of the current URL
  493. </p>
  494. </li>
  495. <li>
  496. <p>
  497. <code>{title}</code> expands to the current page&#8217;s title
  498. </p>
  499. </li>
  500. <li>
  501. <p>
  502. <code>{clipboard}</code> expands to the clipboard contents
  503. </p>
  504. </li>
  505. <li>
  506. <p>
  507. <code>{primary}</code> expands to the primary selection contents
  508. </p>
  509. </li>
  510. </ul></div>
  511. <div class="paragraph"><p>Those variables can be escaped by doubling the braces, e.g. <code>{{url}}</code>. It is
  512. possible to run or bind multiple commands by separating them with <code>;;</code>.</p></div>
  513. </div>
  514. </div>
  515. <div class="sect1">
  516. <h2 id="_normal_commands">Normal commands</h2>
  517. <div class="sectionbody">
  518. <div class="tableblock">
  519. <table rules="all"
  520. width="75%"
  521. frame="border"
  522. cellspacing="0" cellpadding="4">
  523. <caption class="title">Table 1. Quick reference</caption>
  524. <col width="25%" />
  525. <col width="75%" />
  526. <thead>
  527. <tr>
  528. <th align="left" valign="top">Command</th>
  529. <th align="left" valign="top">Description</th>
  530. </tr>
  531. </thead>
  532. <tbody>
  533. <tr>
  534. <td align="left" valign="top"><p class="table"><a href="#adblock-update">adblock-update</a></p></td>
  535. <td align="left" valign="top"><p class="table">Update block lists for both the host- and the Brave ad blocker.</p></td>
  536. </tr>
  537. <tr>
  538. <td align="left" valign="top"><p class="table"><a href="#back">back</a></p></td>
  539. <td align="left" valign="top"><p class="table">Go back in the history of the current tab.</p></td>
  540. </tr>
  541. <tr>
  542. <td align="left" valign="top"><p class="table"><a href="#bind">bind</a></p></td>
  543. <td align="left" valign="top"><p class="table">Bind a key to a command.</p></td>
  544. </tr>
  545. <tr>
  546. <td align="left" valign="top"><p class="table"><a href="#bookmark-add">bookmark-add</a></p></td>
  547. <td align="left" valign="top"><p class="table">Save the current page as a bookmark, or a specific url.</p></td>
  548. </tr>
  549. <tr>
  550. <td align="left" valign="top"><p class="table"><a href="#bookmark-del">bookmark-del</a></p></td>
  551. <td align="left" valign="top"><p class="table">Delete a bookmark.</p></td>
  552. </tr>
  553. <tr>
  554. <td align="left" valign="top"><p class="table"><a href="#bookmark-list">bookmark-list</a></p></td>
  555. <td align="left" valign="top"><p class="table">Show all bookmarks/quickmarks.</p></td>
  556. </tr>
  557. <tr>
  558. <td align="left" valign="top"><p class="table"><a href="#bookmark-load">bookmark-load</a></p></td>
  559. <td align="left" valign="top"><p class="table">Load a bookmark.</p></td>
  560. </tr>
  561. <tr>
  562. <td align="left" valign="top"><p class="table"><a href="#clear-keychain">clear-keychain</a></p></td>
  563. <td align="left" valign="top"><p class="table">Clear the currently entered key chain.</p></td>
  564. </tr>
  565. <tr>
  566. <td align="left" valign="top"><p class="table"><a href="#clear-messages">clear-messages</a></p></td>
  567. <td align="left" valign="top"><p class="table">Clear all message notifications.</p></td>
  568. </tr>
  569. <tr>
  570. <td align="left" valign="top"><p class="table"><a href="#click-element">click-element</a></p></td>
  571. <td align="left" valign="top"><p class="table">Click the element matching the given filter.</p></td>
  572. </tr>
  573. <tr>
  574. <td align="left" valign="top"><p class="table"><a href="#close">close</a></p></td>
  575. <td align="left" valign="top"><p class="table">Close the current window.</p></td>
  576. </tr>
  577. <tr>
  578. <td align="left" valign="top"><p class="table"><a href="#config-clear">config-clear</a></p></td>
  579. <td align="left" valign="top"><p class="table">Set all settings back to their default.</p></td>
  580. </tr>
  581. <tr>
  582. <td align="left" valign="top"><p class="table"><a href="#config-cycle">config-cycle</a></p></td>
  583. <td align="left" valign="top"><p class="table">Cycle an option between multiple values.</p></td>
  584. </tr>
  585. <tr>
  586. <td align="left" valign="top"><p class="table"><a href="#config-dict-add">config-dict-add</a></p></td>
  587. <td align="left" valign="top"><p class="table">Add a key/value pair to a dictionary option.</p></td>
  588. </tr>
  589. <tr>
  590. <td align="left" valign="top"><p class="table"><a href="#config-dict-remove">config-dict-remove</a></p></td>
  591. <td align="left" valign="top"><p class="table">Remove a key from a dict.</p></td>
  592. </tr>
  593. <tr>
  594. <td align="left" valign="top"><p class="table"><a href="#config-diff">config-diff</a></p></td>
  595. <td align="left" valign="top"><p class="table">Show all customized options.</p></td>
  596. </tr>
  597. <tr>
  598. <td align="left" valign="top"><p class="table"><a href="#config-edit">config-edit</a></p></td>
  599. <td align="left" valign="top"><p class="table">Open the config.py file in the editor.</p></td>
  600. </tr>
  601. <tr>
  602. <td align="left" valign="top"><p class="table"><a href="#config-list-add">config-list-add</a></p></td>
  603. <td align="left" valign="top"><p class="table">Append a value to a config option that is a list.</p></td>
  604. </tr>
  605. <tr>
  606. <td align="left" valign="top"><p class="table"><a href="#config-list-remove">config-list-remove</a></p></td>
  607. <td align="left" valign="top"><p class="table">Remove a value from a list.</p></td>
  608. </tr>
  609. <tr>
  610. <td align="left" valign="top"><p class="table"><a href="#config-source">config-source</a></p></td>
  611. <td align="left" valign="top"><p class="table">Read a config.py file.</p></td>
  612. </tr>
  613. <tr>
  614. <td align="left" valign="top"><p class="table"><a href="#config-unset">config-unset</a></p></td>
  615. <td align="left" valign="top"><p class="table">Unset an option.</p></td>
  616. </tr>
  617. <tr>
  618. <td align="left" valign="top"><p class="table"><a href="#config-write-py">config-write-py</a></p></td>
  619. <td align="left" valign="top"><p class="table">Write the current configuration to a config.py file.</p></td>
  620. </tr>
  621. <tr>
  622. <td align="left" valign="top"><p class="table"><a href="#devtools">devtools</a></p></td>
  623. <td align="left" valign="top"><p class="table">Toggle the developer tools (web inspector).</p></td>
  624. </tr>
  625. <tr>
  626. <td align="left" valign="top"><p class="table"><a href="#devtools-focus">devtools-focus</a></p></td>
  627. <td align="left" valign="top"><p class="table">Toggle focus between the devtools/tab.</p></td>
  628. </tr>
  629. <tr>
  630. <td align="left" valign="top"><p class="table"><a href="#download">download</a></p></td>
  631. <td align="left" valign="top"><p class="table">Download a given URL, or current page if no URL given.</p></td>
  632. </tr>
  633. <tr>
  634. <td align="left" valign="top"><p class="table"><a href="#download-cancel">download-cancel</a></p></td>
  635. <td align="left" valign="top"><p class="table">Cancel the last/[count]th download.</p></td>
  636. </tr>
  637. <tr>
  638. <td align="left" valign="top"><p class="table"><a href="#download-clear">download-clear</a></p></td>
  639. <td align="left" valign="top"><p class="table">Remove all finished downloads from the list.</p></td>
  640. </tr>
  641. <tr>
  642. <td align="left" valign="top"><p class="table"><a href="#download-delete">download-delete</a></p></td>
  643. <td align="left" valign="top"><p class="table">Delete the last/[count]th download from disk.</p></td>
  644. </tr>
  645. <tr>
  646. <td align="left" valign="top"><p class="table"><a href="#download-open">download-open</a></p></td>
  647. <td align="left" valign="top"><p class="table">Open the last/[count]th download.</p></td>
  648. </tr>
  649. <tr>
  650. <td align="left" valign="top"><p class="table"><a href="#download-remove">download-remove</a></p></td>
  651. <td align="left" valign="top"><p class="table">Remove the last/[count]th download from the list.</p></td>
  652. </tr>
  653. <tr>
  654. <td align="left" valign="top"><p class="table"><a href="#download-retry">download-retry</a></p></td>
  655. <td align="left" valign="top"><p class="table">Retry the first failed/[count]th download.</p></td>
  656. </tr>
  657. <tr>
  658. <td align="left" valign="top"><p class="table"><a href="#edit-command">edit-command</a></p></td>
  659. <td align="left" valign="top"><p class="table">Open an editor to modify the current command.</p></td>
  660. </tr>
  661. <tr>
  662. <td align="left" valign="top"><p class="table"><a href="#edit-text">edit-text</a></p></td>
  663. <td align="left" valign="top"><p class="table">Open an external editor with the currently selected form field.</p></td>
  664. </tr>
  665. <tr>
  666. <td align="left" valign="top"><p class="table"><a href="#edit-url">edit-url</a></p></td>
  667. <td align="left" valign="top"><p class="table">Navigate to a url formed in an external editor.</p></td>
  668. </tr>
  669. <tr>
  670. <td align="left" valign="top"><p class="table"><a href="#fake-key">fake-key</a></p></td>
  671. <td align="left" valign="top"><p class="table">Send a fake keypress or key string to the website or qutebrowser.</p></td>
  672. </tr>
  673. <tr>
  674. <td align="left" valign="top"><p class="table"><a href="#forward">forward</a></p></td>
  675. <td align="left" valign="top"><p class="table">Go forward in the history of the current tab.</p></td>
  676. </tr>
  677. <tr>
  678. <td align="left" valign="top"><p class="table"><a href="#fullscreen">fullscreen</a></p></td>
  679. <td align="left" valign="top"><p class="table">Toggle fullscreen mode.</p></td>
  680. </tr>
  681. <tr>
  682. <td align="left" valign="top"><p class="table"><a href="#greasemonkey-reload">greasemonkey-reload</a></p></td>
  683. <td align="left" valign="top"><p class="table">Re-read Greasemonkey scripts from disk.</p></td>
  684. </tr>
  685. <tr>
  686. <td align="left" valign="top"><p class="table"><a href="#help">help</a></p></td>
  687. <td align="left" valign="top"><p class="table">Show help about a command or setting.</p></td>
  688. </tr>
  689. <tr>
  690. <td align="left" valign="top"><p class="table"><a href="#hint">hint</a></p></td>
  691. <td align="left" valign="top"><p class="table">Start hinting.</p></td>
  692. </tr>
  693. <tr>
  694. <td align="left" valign="top"><p class="table"><a href="#history">history</a></p></td>
  695. <td align="left" valign="top"><p class="table">Show browsing history.</p></td>
  696. </tr>
  697. <tr>
  698. <td align="left" valign="top"><p class="table"><a href="#history-clear">history-clear</a></p></td>
  699. <td align="left" valign="top"><p class="table">Clear all browsing history.</p></td>
  700. </tr>
  701. <tr>
  702. <td align="left" valign="top"><p class="table"><a href="#home">home</a></p></td>
  703. <td align="left" valign="top"><p class="table">Open main startpage in current tab.</p></td>
  704. </tr>
  705. <tr>
  706. <td align="left" valign="top"><p class="table"><a href="#insert-text">insert-text</a></p></td>
  707. <td align="left" valign="top"><p class="table">Insert text at cursor position.</p></td>
  708. </tr>
  709. <tr>
  710. <td align="left" valign="top"><p class="table"><a href="#jseval">jseval</a></p></td>
  711. <td align="left" valign="top"><p class="table">Evaluate a JavaScript string.</p></td>
  712. </tr>
  713. <tr>
  714. <td align="left" valign="top"><p class="table"><a href="#jump-mark">jump-mark</a></p></td>
  715. <td align="left" valign="top"><p class="table">Jump to the mark named by <code>key</code>.</p></td>
  716. </tr>
  717. <tr>
  718. <td align="left" valign="top"><p class="table"><a href="#later">later</a></p></td>
  719. <td align="left" valign="top"><p class="table">Execute a command after some time.</p></td>
  720. </tr>
  721. <tr>
  722. <td align="left" valign="top"><p class="table"><a href="#macro-record">macro-record</a></p></td>
  723. <td align="left" valign="top"><p class="table">Start or stop recording a macro.</p></td>
  724. </tr>
  725. <tr>
  726. <td align="left" valign="top"><p class="table"><a href="#macro-run">macro-run</a></p></td>
  727. <td align="left" valign="top"><p class="table">Run a recorded macro.</p></td>
  728. </tr>
  729. <tr>
  730. <td align="left" valign="top"><p class="table"><a href="#message-error">message-error</a></p></td>
  731. <td align="left" valign="top"><p class="table">Show an error message in the statusbar.</p></td>
  732. </tr>
  733. <tr>
  734. <td align="left" valign="top"><p class="table"><a href="#message-info">message-info</a></p></td>
  735. <td align="left" valign="top"><p class="table">Show an info message in the statusbar.</p></td>
  736. </tr>
  737. <tr>
  738. <td align="left" valign="top"><p class="table"><a href="#message-warning">message-warning</a></p></td>
  739. <td align="left" valign="top"><p class="table">Show a warning message in the statusbar.</p></td>
  740. </tr>
  741. <tr>
  742. <td align="left" valign="top"><p class="table"><a href="#messages">messages</a></p></td>
  743. <td align="left" valign="top"><p class="table">Show a log of past messages.</p></td>
  744. </tr>
  745. <tr>
  746. <td align="left" valign="top"><p class="table"><a href="#mode-enter">mode-enter</a></p></td>
  747. <td align="left" valign="top"><p class="table">Enter a key mode.</p></td>
  748. </tr>
  749. <tr>
  750. <td align="left" valign="top"><p class="table"><a href="#navigate">navigate</a></p></td>
  751. <td align="left" valign="top"><p class="table">Open typical prev/next links or navigate using the URL path.</p></td>
  752. </tr>
  753. <tr>
  754. <td align="left" valign="top"><p class="table"><a href="#nop">nop</a></p></td>
  755. <td align="left" valign="top"><p class="table">Do nothing.</p></td>
  756. </tr>
  757. <tr>
  758. <td align="left" valign="top"><p class="table"><a href="#open">open</a></p></td>
  759. <td align="left" valign="top"><p class="table">Open a URL in the current/[count]th tab.</p></td>
  760. </tr>
  761. <tr>
  762. <td align="left" valign="top"><p class="table"><a href="#print">print</a></p></td>
  763. <td align="left" valign="top"><p class="table">Print the current/[count]th tab.</p></td>
  764. </tr>
  765. <tr>
  766. <td align="left" valign="top"><p class="table"><a href="#process">process</a></p></td>
  767. <td align="left" valign="top"><p class="table">Manage processes spawned by qutebrowser.</p></td>
  768. </tr>
  769. <tr>
  770. <td align="left" valign="top"><p class="table"><a href="#quickmark-add">quickmark-add</a></p></td>
  771. <td align="left" valign="top"><p class="table">Add a new quickmark.</p></td>
  772. </tr>
  773. <tr>
  774. <td align="left" valign="top"><p class="table"><a href="#quickmark-del">quickmark-del</a></p></td>
  775. <td align="left" valign="top"><p class="table">Delete a quickmark.</p></td>
  776. </tr>
  777. <tr>
  778. <td align="left" valign="top"><p class="table"><a href="#quickmark-load">quickmark-load</a></p></td>
  779. <td align="left" valign="top"><p class="table">Load a quickmark.</p></td>
  780. </tr>
  781. <tr>
  782. <td align="left" valign="top"><p class="table"><a href="#quickmark-save">quickmark-save</a></p></td>
  783. <td align="left" valign="top"><p class="table">Save the current page as a quickmark.</p></td>
  784. </tr>
  785. <tr>
  786. <td align="left" valign="top"><p class="table"><a href="#quit">quit</a></p></td>
  787. <td align="left" valign="top"><p class="table">Quit qutebrowser.</p></td>
  788. </tr>
  789. <tr>
  790. <td align="left" valign="top"><p class="table"><a href="#reload">reload</a></p></td>
  791. <td align="left" valign="top"><p class="table">Reload the current/[count]th tab.</p></td>
  792. </tr>
  793. <tr>
  794. <td align="left" valign="top"><p class="table"><a href="#repeat">repeat</a></p></td>
  795. <td align="left" valign="top"><p class="table">Repeat a given command.</p></td>
  796. </tr>
  797. <tr>
  798. <td align="left" valign="top"><p class="table"><a href="#repeat-command">repeat-command</a></p></td>
  799. <td align="left" valign="top"><p class="table">Repeat the last executed command.</p></td>
  800. </tr>
  801. <tr>
  802. <td align="left" valign="top"><p class="table"><a href="#report">report</a></p></td>
  803. <td align="left" valign="top"><p class="table">Report a bug in qutebrowser.</p></td>
  804. </tr>
  805. <tr>
  806. <td align="left" valign="top"><p class="table"><a href="#restart">restart</a></p></td>
  807. <td align="left" valign="top"><p class="table">Restart qutebrowser while keeping existing tabs open.</p></td>
  808. </tr>
  809. <tr>
  810. <td align="left" valign="top"><p class="table"><a href="#run-with-count">run-with-count</a></p></td>
  811. <td align="left" valign="top"><p class="table">Run a command with the given count.</p></td>
  812. </tr>
  813. <tr>
  814. <td align="left" valign="top"><p class="table"><a href="#save">save</a></p></td>
  815. <td align="left" valign="top"><p class="table">Save configs and state.</p></td>
  816. </tr>
  817. <tr>
  818. <td align="left" valign="top"><p class="table"><a href="#screenshot">screenshot</a></p></td>
  819. <td align="left" valign="top"><p class="table">Take a screenshot of the currently shown part of the page.</p></td>
  820. </tr>
  821. <tr>
  822. <td align="left" valign="top"><p class="table"><a href="#scroll">scroll</a></p></td>
  823. <td align="left" valign="top"><p class="table">Scroll the current tab in the given direction.</p></td>
  824. </tr>
  825. <tr>
  826. <td align="left" valign="top"><p class="table"><a href="#scroll-page">scroll-page</a></p></td>
  827. <td align="left" valign="top"><p class="table">Scroll the frame page-wise.</p></td>
  828. </tr>
  829. <tr>
  830. <td align="left" valign="top"><p class="table"><a href="#scroll-px">scroll-px</a></p></td>
  831. <td align="left" valign="top"><p class="table">Scroll the current tab by <em>count * dx/dy</em> pixels.</p></td>
  832. </tr>
  833. <tr>
  834. <td align="left" valign="top"><p class="table"><a href="#scroll-to-anchor">scroll-to-anchor</a></p></td>
  835. <td align="left" valign="top"><p class="table">Scroll to the given anchor in the document.</p></td>
  836. </tr>
  837. <tr>
  838. <td align="left" valign="top"><p class="table"><a href="#scroll-to-perc">scroll-to-perc</a></p></td>
  839. <td align="left" valign="top"><p class="table">Scroll to a specific percentage of the page.</p></td>
  840. </tr>
  841. <tr>
  842. <td align="left" valign="top"><p class="table"><a href="#search">search</a></p></td>
  843. <td align="left" valign="top"><p class="table">Search for a text on the current page. With no text, clear results.</p></td>
  844. </tr>
  845. <tr>
  846. <td align="left" valign="top"><p class="table"><a href="#search-next">search-next</a></p></td>
  847. <td align="left" valign="top"><p class="table">Continue the search to the ([count]th) next term.</p></td>
  848. </tr>
  849. <tr>
  850. <td align="left" valign="top"><p class="table"><a href="#search-prev">search-prev</a></p></td>
  851. <td align="left" valign="top"><p class="table">Continue the search to the ([count]th) previous term.</p></td>
  852. </tr>
  853. <tr>
  854. <td align="left" valign="top"><p class="table"><a href="#selection-follow">selection-follow</a></p></td>
  855. <td align="left" valign="top"><p class="table">Follow the selected text.</p></td>
  856. </tr>
  857. <tr>
  858. <td align="left" valign="top"><p class="table"><a href="#session-delete">session-delete</a></p></td>
  859. <td align="left" valign="top"><p class="table">Delete a session.</p></td>
  860. </tr>
  861. <tr>
  862. <td align="left" valign="top"><p class="table"><a href="#session-load">session-load</a></p></td>
  863. <td align="left" valign="top"><p class="table">Load a session.</p></td>
  864. </tr>
  865. <tr>
  866. <td align="left" valign="top"><p class="table"><a href="#session-save">session-save</a></p></td>
  867. <td align="left" valign="top"><p class="table">Save a session.</p></td>
  868. </tr>
  869. <tr>
  870. <td align="left" valign="top"><p class="table"><a href="#set">set</a></p></td>
  871. <td align="left" valign="top"><p class="table">Set an option.</p></td>
  872. </tr>
  873. <tr>
  874. <td align="left" valign="top"><p class="table"><a href="#set-cmd-text">set-cmd-text</a></p></td>
  875. <td align="left" valign="top"><p class="table">Preset the statusbar to some text.</p></td>
  876. </tr>
  877. <tr>
  878. <td align="left" valign="top"><p class="table"><a href="#set-mark">set-mark</a></p></td>
  879. <td align="left" valign="top"><p class="table">Set a mark at the current scroll position in the current tab.</p></td>
  880. </tr>
  881. <tr>
  882. <td align="left" valign="top"><p class="table"><a href="#spawn">spawn</a></p></td>
  883. <td align="left" valign="top"><p class="table">Spawn an external command.</p></td>
  884. </tr>
  885. <tr>
  886. <td align="left" valign="top"><p class="table"><a href="#stop">stop</a></p></td>
  887. <td align="left" valign="top"><p class="table">Stop loading in the current/[count]th tab.</p></td>
  888. </tr>
  889. <tr>
  890. <td align="left" valign="top"><p class="table"><a href="#tab-clone">tab-clone</a></p></td>
  891. <td align="left" valign="top"><p class="table">Duplicate the current tab.</p></td>
  892. </tr>
  893. <tr>
  894. <td align="left" valign="top"><p class="table"><a href="#tab-close">tab-close</a></p></td>
  895. <td align="left" valign="top"><p class="table">Close the current/[count]th tab.</p></td>
  896. </tr>
  897. <tr>
  898. <td align="left" valign="top"><p class="table"><a href="#tab-focus">tab-focus</a></p></td>
  899. <td align="left" valign="top"><p class="table">Select the tab given as argument/[count].</p></td>
  900. </tr>
  901. <tr>
  902. <td align="left" valign="top"><p class="table"><a href="#tab-give">tab-give</a></p></td>
  903. <td align="left" valign="top"><p class="table">Give the current tab to a new or existing window if win_id given.</p></td>
  904. </tr>
  905. <tr>
  906. <td align="left" valign="top"><p class="table"><a href="#tab-move">tab-move</a></p></td>
  907. <td align="left" valign="top"><p class="table">Move the current tab according to the argument and [count].</p></td>
  908. </tr>
  909. <tr>
  910. <td align="left" valign="top"><p class="table"><a href="#tab-mute">tab-mute</a></p></td>
  911. <td align="left" valign="top"><p class="table">Mute/Unmute the current/[count]th tab.</p></td>
  912. </tr>
  913. <tr>
  914. <td align="left" valign="top"><p class="table"><a href="#tab-next">tab-next</a></p></td>
  915. <td align="left" valign="top"><p class="table">Switch to the next tab, or switch [count] tabs forward.</p></td>
  916. </tr>
  917. <tr>
  918. <td align="left" valign="top"><p class="table"><a href="#tab-only">tab-only</a></p></td>
  919. <td align="left" valign="top"><p class="table">Close all tabs except for the current one.</p></td>
  920. </tr>
  921. <tr>
  922. <td align="left" valign="top"><p class="table"><a href="#tab-pin">tab-pin</a></p></td>
  923. <td align="left" valign="top"><p class="table">Pin/Unpin the current/[count]th tab.</p></td>
  924. </tr>
  925. <tr>
  926. <td align="left" valign="top"><p class="table"><a href="#tab-prev">tab-prev</a></p></td>
  927. <td align="left" valign="top"><p class="table">Switch to the previous tab, or switch [count] tabs back.</p></td>
  928. </tr>
  929. <tr>
  930. <td align="left" valign="top"><p class="table"><a href="#tab-select">tab-select</a></p></td>
  931. <td align="left" valign="top"><p class="table">Select tab by index or url/title best match.</p></td>
  932. </tr>
  933. <tr>
  934. <td align="left" valign="top"><p class="table"><a href="#tab-take">tab-take</a></p></td>
  935. <td align="left" valign="top"><p class="table">Take a tab from another window.</p></td>
  936. </tr>
  937. <tr>
  938. <td align="left" valign="top"><p class="table"><a href="#unbind">unbind</a></p></td>
  939. <td align="left" valign="top"><p class="table">Unbind a keychain.</p></td>
  940. </tr>
  941. <tr>
  942. <td align="left" valign="top"><p class="table"><a href="#undo">undo</a></p></td>
  943. <td align="left" valign="top"><p class="table">Re-open the last closed tab(s) or window.</p></td>
  944. </tr>
  945. <tr>
  946. <td align="left" valign="top"><p class="table"><a href="#version">version</a></p></td>
  947. <td align="left" valign="top"><p class="table">Show version information.</p></td>
  948. </tr>
  949. <tr>
  950. <td align="left" valign="top"><p class="table"><a href="#view-source">view-source</a></p></td>
  951. <td align="left" valign="top"><p class="table">Show the source of the current page in a new tab.</p></td>
  952. </tr>
  953. <tr>
  954. <td align="left" valign="top"><p class="table"><a href="#window-only">window-only</a></p></td>
  955. <td align="left" valign="top"><p class="table">Close all windows except for the current one.</p></td>
  956. </tr>
  957. <tr>
  958. <td align="left" valign="top"><p class="table"><a href="#yank">yank</a></p></td>
  959. <td align="left" valign="top"><p class="table">Yank (copy) something to the clipboard or primary selection.</p></td>
  960. </tr>
  961. <tr>
  962. <td align="left" valign="top"><p class="table"><a href="#zoom">zoom</a></p></td>
  963. <td align="left" valign="top"><p class="table">Set the zoom level for the current tab.</p></td>
  964. </tr>
  965. <tr>
  966. <td align="left" valign="top"><p class="table"><a href="#zoom-in">zoom-in</a></p></td>
  967. <td align="left" valign="top"><p class="table">Increase the zoom level for the current tab.</p></td>
  968. </tr>
  969. <tr>
  970. <td align="left" valign="top"><p class="table"><a href="#zoom-out">zoom-out</a></p></td>
  971. <td align="left" valign="top"><p class="table">Decrease the zoom level for the current tab.</p></td>
  972. </tr>
  973. </tbody>
  974. </table>
  975. </div>
  976. <div class="sect2">
  977. <h3 id="adblock-update">adblock-update</h3>
  978. <div class="paragraph"><p>Update block lists for both the host- and the Brave ad blocker.</p></div>
  979. </div>
  980. <div class="sect2">
  981. <h3 id="back">back</h3>
  982. <div class="paragraph"><p>Syntax: <code>:back [<strong>--tab</strong>] [<strong>--bg</strong>] [<strong>--window</strong>] [<em>index</em>]</code></p></div>
  983. <div class="paragraph"><p>Go back in the history of the current tab.</p></div>
  984. <div class="sect3">
  985. <h4 id="_positional_arguments">positional arguments</h4>
  986. <div class="ulist"><ul>
  987. <li>
  988. <p>
  989. <code><em>index</em></code>: Which page to go back to, count takes precedence.
  990. </p>
  991. </li>
  992. </ul></div>
  993. </div>
  994. <div class="sect3">
  995. <h4 id="_optional_arguments">optional arguments</h4>
  996. <div class="ulist"><ul>
  997. <li>
  998. <p>
  999. <code><strong>-t</strong></code>, <code><strong>--tab</strong></code>: Go back in a new tab.
  1000. </p>
  1001. </li>
  1002. <li>
  1003. <p>
  1004. <code><strong>-b</strong></code>, <code><strong>--bg</strong></code>: Go back in a background tab.
  1005. </p>
  1006. </li>
  1007. <li>
  1008. <p>
  1009. <code><strong>-w</strong></code>, <code><strong>--window</strong></code>: Go back in a new window.
  1010. </p>
  1011. </li>
  1012. </ul></div>
  1013. </div>
  1014. <div class="sect3">
  1015. <h4 id="_count">count</h4>
  1016. <div class="paragraph"><p>How many pages to go back.</p></div>
  1017. </div>
  1018. </div>
  1019. <div class="sect2">
  1020. <h3 id="bind">bind</h3>
  1021. <div class="paragraph"><p>Syntax: <code>:bind [<strong>--mode</strong> <em>mode</em>] [<strong>--default</strong>] [<em>key</em>] [<em>command</em>]</code></p></div>
  1022. <div class="paragraph"><p>Bind a key to a command.</p></div>
  1023. <div class="paragraph"><p>If no command is given, show the current binding for the given key. Using :bind without any arguments opens a page showing all keybindings.</p></div>
  1024. <div class="sect3">
  1025. <h4 id="_positional_arguments_2">positional arguments</h4>
  1026. <div class="ulist"><ul>
  1027. <li>
  1028. <p>
  1029. <code><em>key</em></code>: The keychain to bind. Examples of valid keychains are <code>gC</code>, <code>&lt;Ctrl-X&gt;</code> or <code>&lt;Ctrl-C&gt;a</code>.
  1030. </p>
  1031. </li>
  1032. <li>
  1033. <p>
  1034. <code><em>command</em></code>: The command to execute, with optional args.
  1035. </p>
  1036. </li>
  1037. </ul></div>
  1038. </div>
  1039. <div class="sect3">
  1040. <h4 id="_optional_arguments_2">optional arguments</h4>
  1041. <div class="ulist"><ul>
  1042. <li>
  1043. <p>
  1044. <code><strong>-m</strong></code>, <code><strong>--mode</strong></code>: The mode to bind the key in (default: <code>normal</code>). See <code>:help bindings.commands</code> for the available modes.
  1045. </p>
  1046. </li>
  1047. <li>
  1048. <p>
  1049. <code><strong>-d</strong></code>, <code><strong>--default</strong></code>: If given, restore a default binding.
  1050. </p>
  1051. </li>
  1052. </ul></div>
  1053. </div>
  1054. <div class="sect3">
  1055. <h4 id="_note">note</h4>
  1056. <div class="ulist"><ul>
  1057. <li>
  1058. <p>
  1059. This command does not split arguments after the last argument and handles quotes literally.
  1060. </p>
  1061. </li>
  1062. <li>
  1063. <p>
  1064. With this command, <code>;;</code> is interpreted literally instead of splitting off a second command.
  1065. </p>
  1066. </li>
  1067. <li>
  1068. <p>
  1069. This command does not replace variables like <code>{url}</code>.
  1070. </p>
  1071. </li>
  1072. </ul></div>
  1073. </div>
  1074. </div>
  1075. <div class="sect2">
  1076. <h3 id="bookmark-add">bookmark-add</h3>
  1077. <div class="paragraph"><p>Syntax: <code>:bookmark-add [<strong>--toggle</strong>] [<em>url</em>] [<em>title</em>]</code></p></div>
  1078. <div class="paragraph"><p>Save the current page as a bookmark, or a specific url.</p></div>
  1079. <div class="paragraph"><p>If no url and title are provided, then save the current page as a bookmark. If a url and title have been provided, then save the given url as a bookmark with the provided title. You can view all saved bookmarks on the <a href="qute://bookmarks">bookmarks page</a>.</p></div>
  1080. <div class="sect3">
  1081. <h4 id="_positional_arguments_3">positional arguments</h4>
  1082. <div class="ulist"><ul>
  1083. <li>
  1084. <p>
  1085. <code><em>url</em></code>: url to save as a bookmark. If not given, use url of current page.
  1086. </p>
  1087. </li>
  1088. <li>
  1089. <p>
  1090. <code><em>title</em></code>: title of the new bookmark.
  1091. </p>
  1092. </li>
  1093. </ul></div>
  1094. </div>
  1095. <div class="sect3">
  1096. <h4 id="_optional_arguments_3">optional arguments</h4>
  1097. <div class="ulist"><ul>
  1098. <li>
  1099. <p>
  1100. <code><strong>-t</strong></code>, <code><strong>--toggle</strong></code>: remove the bookmark instead of raising an error if it already exists.
  1101. </p>
  1102. </li>
  1103. </ul></div>
  1104. </div>
  1105. </div>
  1106. <div class="sect2">
  1107. <h3 id="bookmark-del">bookmark-del</h3>
  1108. <div class="paragraph"><p>Syntax: <code>:bookmark-del [<em>url</em>]</code></p></div>
  1109. <div class="paragraph"><p>Delete a bookmark.</p></div>
  1110. <div class="sect3">
  1111. <h4 id="_positional_arguments_4">positional arguments</h4>
  1112. <div class="ulist"><ul>
  1113. <li>
  1114. <p>
  1115. <code><em>url</em></code>: The url of the bookmark to delete. If not given, use the current page&#8217;s url.
  1116. </p>
  1117. </li>
  1118. </ul></div>
  1119. </div>
  1120. <div class="sect3">
  1121. <h4 id="_note_2">note</h4>
  1122. <div class="ulist"><ul>
  1123. <li>
  1124. <p>
  1125. This command does not split arguments after the last argument and handles quotes literally.
  1126. </p>
  1127. </li>
  1128. </ul></div>
  1129. </div>
  1130. </div>
  1131. <div class="sect2">
  1132. <h3 id="bookmark-list">bookmark-list</h3>
  1133. <div class="paragraph"><p>Syntax: <code>:bookmark-list [<strong>--jump</strong>] [<strong>--tab</strong>] [<strong>--bg</strong>] [<strong>--window</strong>]</code></p></div>
  1134. <div class="paragraph"><p>Show all bookmarks/quickmarks.</p></div>
  1135. <div class="sect3">
  1136. <h4 id="_optional_arguments_4">optional arguments</h4>
  1137. <div class="ulist"><ul>
  1138. <li>
  1139. <p>
  1140. <code><strong>-j</strong></code>, <code><strong>--jump</strong></code>: Jump to the "bookmarks" header.
  1141. </p>
  1142. </li>
  1143. <li>
  1144. <p>
  1145. <code><strong>-t</strong></code>, <code><strong>--tab</strong></code>: Open in a new tab.
  1146. </p>
  1147. </li>
  1148. <li>
  1149. <p>
  1150. <code><strong>-b</strong></code>, <code><strong>--bg</strong></code>: Open in a background tab.
  1151. </p>
  1152. </li>
  1153. <li>
  1154. <p>
  1155. <code><strong>-w</strong></code>, <code><strong>--window</strong></code>: Open in a new window.
  1156. </p>
  1157. </li>
  1158. </ul></div>
  1159. </div>
  1160. </div>
  1161. <div class="sect2">
  1162. <h3 id="bookmark-load">bookmark-load</h3>
  1163. <div class="paragraph"><p>Syntax: <code>:bookmark-load [<strong>--tab</strong>] [<strong>--bg</strong>] [<strong>--window</strong>] [<strong>--delete</strong>] <em>url</em></code></p></div>
  1164. <div class="paragraph"><p>Load a bookmark.</p></div>
  1165. <div class="sect3">
  1166. <h4 id="_positional_arguments_5">positional arguments</h4>
  1167. <div class="ulist"><ul>
  1168. <li>
  1169. <p>
  1170. <code><em>url</em></code>: The url of the bookmark to load.
  1171. </p>
  1172. </li>
  1173. </ul></div>
  1174. </div>
  1175. <div class="sect3">
  1176. <h4 id="_optional_arguments_5">optional arguments</h4>
  1177. <div class="ulist"><ul>
  1178. <li>
  1179. <p>
  1180. <code><strong>-t</strong></code>, <code><strong>--tab</strong></code>: Load the bookmark in a new tab.
  1181. </p>
  1182. </li>
  1183. <li>
  1184. <p>
  1185. <code><strong>-b</strong></code>, <code><strong>--bg</strong></code>: Load the bookmark in a new background tab.
  1186. </p>
  1187. </li>
  1188. <li>
  1189. <p>
  1190. <code><strong>-w</strong></code>, <code><strong>--window</strong></code>: Load the bookmark in a new window.
  1191. </p>
  1192. </li>
  1193. <li>
  1194. <p>
  1195. <code><strong>-d</strong></code>, <code><strong>--delete</strong></code>: Whether to delete the bookmark afterwards.
  1196. </p>
  1197. </li>
  1198. </ul></div>
  1199. </div>
  1200. <div class="sect3">
  1201. <h4 id="_note_3">note</h4>
  1202. <div class="ulist"><ul>
  1203. <li>
  1204. <p>
  1205. This command does not split arguments after the last argument and handles quotes literally.
  1206. </p>
  1207. </li>
  1208. </ul></div>
  1209. </div>
  1210. </div>
  1211. <div class="sect2">
  1212. <h3 id="clear-keychain">clear-keychain</h3>
  1213. <div class="paragraph"><p>Clear the currently entered key chain.</p></div>
  1214. </div>
  1215. <div class="sect2">
  1216. <h3 id="clear-messages">clear-messages</h3>
  1217. <div class="paragraph"><p>Clear all message notifications.</p></div>
  1218. </div>
  1219. <div class="sect2">
  1220. <h3 id="click-element">click-element</h3>
  1221. <div class="paragraph"><p>Syntax: <code>:click-element [<strong>--target</strong> <em>target</em>] [<strong>--force-event</strong>] <em>filter</em> <em>value</em></code></p></div>
  1222. <div class="paragraph"><p>Click the element matching the given filter.</p></div>
  1223. <div class="paragraph"><p>The given filter needs to result in exactly one element, otherwise, an error is shown.</p></div>
  1224. <div class="sect3">
  1225. <h4 id="_positional_arguments_6">positional arguments</h4>
  1226. <div class="ulist"><ul>
  1227. <li>
  1228. <p>
  1229. <code><em>filter</em></code>: How to filter the elements. id: Get an element based on its ID.
  1230. </p>
  1231. </li>
  1232. <li>
  1233. <p>
  1234. <code><em>value</em></code>: The value to filter for.
  1235. </p>
  1236. </li>
  1237. </ul></div>
  1238. </div>
  1239. <div class="sect3">
  1240. <h4 id="_optional_arguments_6">optional arguments</h4>
  1241. <div class="ulist"><ul>
  1242. <li>
  1243. <p>
  1244. <code><strong>-t</strong></code>, <code><strong>--target</strong></code>: How to open the clicked element (normal/tab/tab-bg/window).
  1245. </p>
  1246. </li>
  1247. <li>
  1248. <p>
  1249. <code><strong>-f</strong></code>, <code><strong>--force-event</strong></code>: Force generating a fake click event.
  1250. </p>
  1251. </li>
  1252. </ul></div>
  1253. </div>
  1254. </div>
  1255. <div class="sect2">
  1256. <h3 id="close">close</h3>
  1257. <div class="paragraph"><p>Close the current window.</p></div>
  1258. </div>
  1259. <div class="sect2">
  1260. <h3 id="config-clear">config-clear</h3>
  1261. <div class="paragraph"><p>Syntax: <code>:config-clear [<strong>--save</strong>]</code></p></div>
  1262. <div class="paragraph"><p>Set all settings back to their default.</p></div>
  1263. <div class="sect3">
  1264. <h4 id="_optional_arguments_7">optional arguments</h4>
  1265. <div class="ulist"><ul>
  1266. <li>
  1267. <p>
  1268. <code><strong>-s</strong></code>, <code><strong>--save</strong></code>: If given, all configuration in autoconfig.yml is also removed.
  1269. </p>
  1270. </li>
  1271. </ul></div>
  1272. </div>
  1273. </div>
  1274. <div class="sect2">
  1275. <h3 id="config-cycle">config-cycle</h3>
  1276. <div class="paragraph"><p>Syntax: <code>:config-cycle [<strong>--pattern</strong> <em>pattern</em>] [<strong>--temp</strong>] [<strong>--print</strong>] <em>option</em> [<em>values</em> &#8230;]</code></p></div>
  1277. <div class="paragraph"><p>Cycle an option between multiple values.</p></div>
  1278. <div class="sect3">
  1279. <h4 id="_positional_arguments_7">positional arguments</h4>
  1280. <div class="ulist"><ul>
  1281. <li>
  1282. <p>
  1283. <code><em>option</em></code>: The name of the option.
  1284. </p>
  1285. </li>
  1286. <li>
  1287. <p>
  1288. <code><em>values</em></code>: The values to cycle through.
  1289. </p>
  1290. </li>
  1291. </ul></div>
  1292. </div>
  1293. <div class="sect3">
  1294. <h4 id="_optional_arguments_8">optional arguments</h4>
  1295. <div class="ulist"><ul>
  1296. <li>
  1297. <p>
  1298. <code><strong>-u</strong></code>, <code><strong>--pattern</strong></code>: The URL pattern to use.
  1299. </p>
  1300. </li>
  1301. <li>
  1302. <p>
  1303. <code><strong>-t</strong></code>, <code><strong>--temp</strong></code>: Set value temporarily until qutebrowser is closed.
  1304. </p>
  1305. </li>
  1306. <li>
  1307. <p>
  1308. <code><strong>-p</strong></code>, <code><strong>--print</strong></code>: Print the value after setting.
  1309. </p>
  1310. </li>
  1311. </ul></div>
  1312. </div>
  1313. </div>
  1314. <div class="sect2">
  1315. <h3 id="config-dict-add">config-dict-add</h3>
  1316. <div class="paragraph"><p>Syntax: <code>:config-dict-add [<strong>--temp</strong>] [<strong>--replace</strong>] <em>option</em> <em>key</em> <em>value</em></code></p></div>
  1317. <div class="paragraph"><p>Add a key/value pair to a dictionary option.</p></div>
  1318. <div class="sect3">
  1319. <h4 id="_positional_arguments_8">positional arguments</h4>
  1320. <div class="ulist"><ul>
  1321. <li>
  1322. <p>
  1323. <code><em>option</em></code>: The name of the option.
  1324. </p>
  1325. </li>
  1326. <li>
  1327. <p>
  1328. <code><em>key</em></code>: The key to use.
  1329. </p>
  1330. </li>
  1331. <li>
  1332. <p>
  1333. <code><em>value</em></code>: The value to place in the dictionary.
  1334. </p>
  1335. </li>
  1336. </ul></div>
  1337. </div>
  1338. <div class="sect3">
  1339. <h4 id="_optional_arguments_9">optional arguments</h4>
  1340. <div class="ulist"><ul>
  1341. <li>
  1342. <p>
  1343. <code><strong>-t</strong></code>, <code><strong>--temp</strong></code>: Add value temporarily until qutebrowser is closed.
  1344. </p>
  1345. </li>
  1346. <li>
  1347. <p>
  1348. <code><strong>-r</strong></code>, <code><strong>--replace</strong></code>: Replace existing values. By default, existing values are not overwritten.
  1349. </p>
  1350. </li>
  1351. </ul></div>
  1352. </div>
  1353. </div>
  1354. <div class="sect2">
  1355. <h3 id="config-dict-remove">config-dict-remove</h3>
  1356. <div class="paragraph"><p>Syntax: <code>:config-dict-remove [<strong>--temp</strong>] <em>option</em> <em>key</em></code></p></div>
  1357. <div class="paragraph"><p>Remove a key from a dict.</p></div>
  1358. <div class="sect3">
  1359. <h4 id="_positional_arguments_9">positional arguments</h4>
  1360. <div class="ulist"><ul>
  1361. <li>
  1362. <p>
  1363. <code><em>option</em></code>: The name of the option.
  1364. </p>
  1365. </li>
  1366. <li>
  1367. <p>
  1368. <code><em>key</em></code>: The key to remove from the dict.
  1369. </p>
  1370. </li>
  1371. </ul></div>
  1372. </div>
  1373. <div class="sect3">
  1374. <h4 id="_optional_arguments_10">optional arguments</h4>
  1375. <div class="ulist"><ul>
  1376. <li>
  1377. <p>
  1378. <code><strong>-t</strong></code>, <code><strong>--temp</strong></code>: Remove value temporarily until qutebrowser is closed.
  1379. </p>
  1380. </li>
  1381. </ul></div>
  1382. </div>
  1383. </div>
  1384. <div class="sect2">
  1385. <h3 id="config-diff">config-diff</h3>
  1386. <div class="paragraph"><p>Show all customized options.</p></div>
  1387. </div>
  1388. <div class="sect2">
  1389. <h3 id="config-edit">config-edit</h3>
  1390. <div class="paragraph"><p>Syntax: <code>:config-edit [<strong>--no-source</strong>]</code></p></div>
  1391. <div class="paragraph"><p>Open the config.py file in the editor.</p></div>
  1392. <div class="sect3">
  1393. <h4 id="_optional_arguments_11">optional arguments</h4>
  1394. <div class="ulist"><ul>
  1395. <li>
  1396. <p>
  1397. <code><strong>-n</strong></code>, <code><strong>--no-source</strong></code>: Don&#8217;t re-source the config file after editing.
  1398. </p>
  1399. </li>
  1400. </ul></div>
  1401. </div>
  1402. </div>
  1403. <div class="sect2">
  1404. <h3 id="config-list-add">config-list-add</h3>
  1405. <div class="paragraph"><p>Syntax: <code>:config-list-add [<strong>--temp</strong>] <em>option</em> <em>value</em></code></p></div>
  1406. <div class="paragraph"><p>Append a value to a config option that is a list.</p></div>
  1407. <div class="sect3">
  1408. <h4 id="_positional_arguments_10">positional arguments</h4>
  1409. <div class="ulist"><ul>
  1410. <li>
  1411. <p>
  1412. <code><em>option</em></code>: The name of the option.
  1413. </p>
  1414. </li>
  1415. <li>
  1416. <p>
  1417. <code><em>value</em></code>: The value to append to the end of the list.
  1418. </p>
  1419. </li>
  1420. </ul></div>
  1421. </div>
  1422. <div class="sect3">
  1423. <h4 id="_optional_arguments_12">optional arguments</h4>
  1424. <div class="ulist"><ul>
  1425. <li>
  1426. <p>
  1427. <code><strong>-t</strong></code>, <code><strong>--temp</strong></code>: Add value temporarily until qutebrowser is closed.
  1428. </p>
  1429. </li>
  1430. </ul></div>
  1431. </div>
  1432. </div>
  1433. <div class="sect2">
  1434. <h3 id="config-list-remove">config-list-remove</h3>
  1435. <div class="paragraph"><p>Syntax: <code>:config-list-remove [<strong>--temp</strong>] <em>option</em> <em>value</em></code></p></div>
  1436. <div class="paragraph"><p>Remove a value from a list.</p></div>
  1437. <div class="sect3">
  1438. <h4 id="_positional_arguments_11">positional arguments</h4>
  1439. <div class="ulist"><ul>
  1440. <li>
  1441. <p>
  1442. <code><em>option</em></code>: The name of the option.
  1443. </p>
  1444. </li>
  1445. <li>
  1446. <p>
  1447. <code><em>value</em></code>: The value to remove from the list.
  1448. </p>
  1449. </li>
  1450. </ul></div>
  1451. </div>
  1452. <div class="sect3">
  1453. <h4 id="_optional_arguments_13">optional arguments</h4>
  1454. <div class="ulist"><ul>
  1455. <li>
  1456. <p>
  1457. <code><strong>-t</strong></code>, <code><strong>--temp</strong></code>: Remove value temporarily until qutebrowser is closed.
  1458. </p>
  1459. </li>
  1460. </ul></div>
  1461. </div>
  1462. </div>
  1463. <div class="sect2">
  1464. <h3 id="config-source">config-source</h3>
  1465. <div class="paragraph"><p>Syntax: <code>:config-source [<strong>--clear</strong>] [<em>filename</em>]</code></p></div>
  1466. <div class="paragraph"><p>Read a config.py file.</p></div>
  1467. <div class="sect3">
  1468. <h4 id="_positional_arguments_12">positional arguments</h4>
  1469. <div class="ulist"><ul>
  1470. <li>
  1471. <p>
  1472. <code><em>filename</em></code>: The file to load. If not given, loads the default config.py.
  1473. </p>
  1474. </li>
  1475. </ul></div>
  1476. </div>
  1477. <div class="sect3">
  1478. <h4 id="_optional_arguments_14">optional arguments</h4>
  1479. <div class="ulist"><ul>
  1480. <li>
  1481. <p>
  1482. <code><strong>-c</strong></code>, <code><strong>--clear</strong></code>: Clear current settings first.
  1483. </p>
  1484. </li>
  1485. </ul></div>
  1486. </div>
  1487. </div>
  1488. <div class="sect2">
  1489. <h3 id="config-unset">config-unset</h3>
  1490. <div class="paragraph"><p>Syntax: <code>:config-unset [<strong>--temp</strong>] <em>option</em></code></p></div>
  1491. <div class="paragraph"><p>Unset an option.</p></div>
  1492. <div class="paragraph"><p>This sets an option back to its default and removes it from autoconfig.yml.</p></div>
  1493. <div class="sect3">
  1494. <h4 id="_positional_arguments_13">positional arguments</h4>
  1495. <div class="ulist"><ul>
  1496. <li>
  1497. <p>
  1498. <code><em>option</em></code>: The name of the option.
  1499. </p>
  1500. </li>
  1501. </ul></div>
  1502. </div>
  1503. <div class="sect3">
  1504. <h4 id="_optional_arguments_15">optional arguments</h4>
  1505. <div class="ulist"><ul>
  1506. <li>
  1507. <p>
  1508. <code><strong>-t</strong></code>, <code><strong>--temp</strong></code>: Set value temporarily until qutebrowser is closed.
  1509. </p>
  1510. </li>
  1511. </ul></div>
  1512. </div>
  1513. </div>
  1514. <div class="sect2">
  1515. <h3 id="config-write-py">config-write-py</h3>
  1516. <div class="paragraph"><p>Syntax: <code>:config-write-py [<strong>--force</strong>] [<strong>--defaults</strong>] [<em>filename</em>]</code></p></div>
  1517. <div class="paragraph"><p>Write the current configuration to a config.py file.</p></div>
  1518. <div class="sect3">
  1519. <h4 id="_positional_arguments_14">positional arguments</h4>
  1520. <div class="ulist"><ul>
  1521. <li>
  1522. <p>
  1523. <code><em>filename</em></code>: The file to write to, or not given for the default config.py.
  1524. </p>
  1525. </li>
  1526. </ul></div>
  1527. </div>
  1528. <div class="sect3">
  1529. <h4 id="_optional_arguments_16">optional arguments</h4>
  1530. <div class="ulist"><ul>
  1531. <li>
  1532. <p>
  1533. <code><strong>-f</strong></code>, <code><strong>--force</strong></code>: Force overwriting existing files.
  1534. </p>
  1535. </li>
  1536. <li>
  1537. <p>
  1538. <code><strong>-d</strong></code>, <code><strong>--defaults</strong></code>: Write the defaults instead of values configured via :set.
  1539. </p>
  1540. </li>
  1541. </ul></div>
  1542. </div>
  1543. </div>
  1544. <div class="sect2">
  1545. <h3 id="devtools">devtools</h3>
  1546. <div class="paragraph"><p>Syntax: <code>:devtools [<em>position</em>]</code></p></div>
  1547. <div class="paragraph"><p>Toggle the developer tools (web inspector).</p></div>
  1548. <div class="sect3">
  1549. <h4 id="_positional_arguments_15">positional arguments</h4>
  1550. <div class="ulist"><ul>
  1551. <li>
  1552. <p>
  1553. <code><em>position</em></code>: Where to open the devtools (right/left/top/bottom/window).
  1554. </p>
  1555. </li>
  1556. </ul></div>
  1557. </div>
  1558. </div>
  1559. <div class="sect2">
  1560. <h3 id="devtools-focus">devtools-focus</h3>
  1561. <div class="paragraph"><p>Toggle focus between the devtools/tab.</p></div>
  1562. </div>
  1563. <div class="sect2">
  1564. <h3 id="download">download</h3>
  1565. <div class="paragraph"><p>Syntax: <code>:download [<strong>--mhtml</strong>] [<strong>--dest</strong> <em>dest</em>] [<em>url</em>]</code></p></div>
  1566. <div class="paragraph"><p>Download a given URL, or current page if no URL given.</p></div>
  1567. <div class="sect3">
  1568. <h4 id="_positional_arguments_16">positional arguments</h4>
  1569. <div class="ulist"><ul>
  1570. <li>
  1571. <p>
  1572. <code><em>url</em></code>: The URL to download. If not given, download the current page.
  1573. </p>
  1574. </li>
  1575. </ul></div>
  1576. </div>
  1577. <div class="sect3">
  1578. <h4 id="_optional_arguments_17">optional arguments</h4>
  1579. <div class="ulist"><ul>
  1580. <li>
  1581. <p>
  1582. <code><strong>-m</strong></code>, <code><strong>--mhtml</strong></code>: Download the current page and all assets as mhtml file.
  1583. </p>
  1584. </li>
  1585. <li>
  1586. <p>
  1587. <code><strong>-d</strong></code>, <code><strong>--dest</strong></code>: The file path to write the download to, or not given to ask.
  1588. </p>
  1589. </li>
  1590. </ul></div>
  1591. </div>
  1592. </div>
  1593. <div class="sect2">
  1594. <h3 id="download-cancel">download-cancel</h3>
  1595. <div class="paragraph"><p>Syntax: <code>:download-cancel [<strong>--all</strong>]</code></p></div>
  1596. <div class="paragraph"><p>Cancel the last/[count]th download.</p></div>
  1597. <div class="sect3">
  1598. <h4 id="_optional_arguments_18">optional arguments</h4>
  1599. <div class="ulist"><ul>
  1600. <li>
  1601. <p>
  1602. <code><strong>-a</strong></code>, <code><strong>--all</strong></code>: Cancel all running downloads
  1603. </p>
  1604. </li>
  1605. </ul></div>
  1606. </div>
  1607. <div class="sect3">
  1608. <h4 id="_count_2">count</h4>
  1609. <div class="paragraph"><p>The index of the download to cancel.</p></div>
  1610. </div>
  1611. </div>
  1612. <div class="sect2">
  1613. <h3 id="download-clear">download-clear</h3>
  1614. <div class="paragraph"><p>Remove all finished downloads from the list.</p></div>
  1615. </div>
  1616. <div class="sect2">
  1617. <h3 id="download-delete">download-delete</h3>
  1618. <div class="paragraph"><p>Delete the last/[count]th download from disk.</p></div>
  1619. <div class="sect3">
  1620. <h4 id="_count_3">count</h4>
  1621. <div class="paragraph"><p>The index of the download to delete.</p></div>
  1622. </div>
  1623. </div>
  1624. <div class="sect2">
  1625. <h3 id="download-open">download-open</h3>
  1626. <div class="paragraph"><p>Syntax: <code>:download-open [<strong>--dir</strong>] [<em>cmdline</em>]</code></p></div>
  1627. <div class="paragraph"><p>Open the last/[count]th download.</p></div>
  1628. <div class="paragraph"><p>If no specific command is given, this will use the system&#8217;s default application to open the file.</p></div>
  1629. <div class="sect3">
  1630. <h4 id="_positional_arguments_17">positional arguments</h4>
  1631. <div class="ulist"><ul>
  1632. <li>
  1633. <p>
  1634. <code><em>cmdline</em></code>: The command which should be used to open the file. A <code>{}</code> is expanded to the temporary file name. If no <code>{}</code> is
  1635. present, the filename is automatically appended to the
  1636. cmdline.
  1637. </p>
  1638. </li>
  1639. </ul></div>
  1640. </div>
  1641. <div class="sect3">
  1642. <h4 id="_optional_arguments_19">optional arguments</h4>
  1643. <div class="ulist"><ul>
  1644. <li>
  1645. <p>
  1646. <code><strong>-d</strong></code>, <code><strong>--dir</strong></code>: Whether to open the file&#8217;s directory instead.
  1647. </p>
  1648. </li>
  1649. </ul></div>
  1650. </div>
  1651. <div class="sect3">
  1652. <h4 id="_count_4">count</h4>
  1653. <div class="paragraph"><p>The index of the download to open.</p></div>
  1654. </div>
  1655. <div class="sect3">
  1656. <h4 id="_note_4">note</h4>
  1657. <div class="ulist"><ul>
  1658. <li>
  1659. <p>
  1660. This command does not split arguments after the last argument and handles quotes literally.
  1661. </p>
  1662. </li>
  1663. </ul></div>
  1664. </div>
  1665. </div>
  1666. <div class="sect2">
  1667. <h3 id="download-remove">download-remove</h3>
  1668. <div class="paragraph"><p>Syntax: <code>:download-remove [<strong>--all</strong>]</code></p></div>
  1669. <div class="paragraph"><p>Remove the last/[count]th download from the list.</p></div>
  1670. <div class="sect3">
  1671. <h4 id="_optional_arguments_20">optional arguments</h4>
  1672. <div class="ulist"><ul>
  1673. <li>
  1674. <p>
  1675. <code><strong>-a</strong></code>, <code><strong>--all</strong></code>: Remove all finished downloads.
  1676. </p>
  1677. </li>
  1678. </ul></div>
  1679. </div>
  1680. <div class="sect3">
  1681. <h4 id="_count_5">count</h4>
  1682. <div class="paragraph"><p>The index of the download to remove.</p></div>
  1683. </div>
  1684. </div>
  1685. <div class="sect2">
  1686. <h3 id="download-retry">download-retry</h3>
  1687. <div class="paragraph"><p>Retry the first failed/[count]th download.</p></div>
  1688. <div class="sect3">
  1689. <h4 id="_count_6">count</h4>
  1690. <div class="paragraph"><p>The index of the download to retry.</p></div>
  1691. </div>
  1692. </div>
  1693. <div class="sect2">
  1694. <h3 id="edit-command">edit-command</h3>
  1695. <div class="paragraph"><p>Syntax: <code>:edit-command [<strong>--run</strong>]</code></p></div>
  1696. <div class="paragraph"><p>Open an editor to modify the current command.</p></div>
  1697. <div class="sect3">
  1698. <h4 id="_optional_arguments_21">optional arguments</h4>
  1699. <div class="ulist"><ul>
  1700. <li>
  1701. <p>
  1702. <code><strong>-r</strong></code>, <code><strong>--run</strong></code>: Run the command if the editor exits successfully.
  1703. </p>
  1704. </li>
  1705. </ul></div>
  1706. </div>
  1707. </div>
  1708. <div class="sect2">
  1709. <h3 id="edit-text">edit-text</h3>
  1710. <div class="paragraph"><p>Open an external editor with the currently selected form field.</p></div>
  1711. <div class="paragraph"><p>The editor which should be launched can be configured via the <code>editor.command</code> config option.</p></div>
  1712. </div>
  1713. <div class="sect2">
  1714. <h3 id="edit-url">edit-url</h3>
  1715. <div class="paragraph"><p>Syntax: <code>:edit-url [<strong>--bg</strong>] [<strong>--tab</strong>] [<strong>--window</strong>] [<strong>--private</strong>] [<strong>--related</strong>] [<em>url</em>]</code></p></div>
  1716. <div class="paragraph"><p>Navigate to a url formed in an external editor.</p></div>
  1717. <div class="paragraph"><p>The editor which should be launched can be configured via the <code>editor.command</code> config option.</p></div>
  1718. <div class="sect3">
  1719. <h4 id="_positional_arguments_18">positional arguments</h4>
  1720. <div class="ulist"><ul>
  1721. <li>
  1722. <p>
  1723. <code><em>url</em></code>: URL to edit; defaults to the current page url.
  1724. </p>
  1725. </li>
  1726. </ul></div>
  1727. </div>
  1728. <div class="sect3">
  1729. <h4 id="_optional_arguments_22">optional arguments</h4>
  1730. <div class="ulist"><ul>
  1731. <li>
  1732. <p>
  1733. <code><strong>-b</strong></code>, <code><strong>--bg</strong></code>: Open in a new background tab.
  1734. </p>
  1735. </li>
  1736. <li>
  1737. <p>
  1738. <code><strong>-t</strong></code>, <code><strong>--tab</strong></code>: Open in a new tab.
  1739. </p>
  1740. </li>
  1741. <li>
  1742. <p>
  1743. <code><strong>-w</strong></code>, <code><strong>--window</strong></code>: Open in a new window.
  1744. </p>
  1745. </li>
  1746. <li>
  1747. <p>
  1748. <code><strong>-p</strong></code>, <code><strong>--private</strong></code>: Open a new window in private browsing mode.
  1749. </p>
  1750. </li>
  1751. <li>
  1752. <p>
  1753. <code><strong>-r</strong></code>, <code><strong>--related</strong></code>: If opening a new tab, position the tab as related to the current one (like clicking on a link).
  1754. </p>
  1755. </li>
  1756. </ul></div>
  1757. </div>
  1758. </div>
  1759. <div class="sect2">
  1760. <h3 id="fake-key">fake-key</h3>
  1761. <div class="paragraph"><p>Syntax: <code>:fake-key [<strong>--global</strong>] <em>keystring</em></code></p></div>
  1762. <div class="paragraph"><p>Send a fake keypress or key string to the website or qutebrowser.</p></div>
  1763. <div class="paragraph"><p>:fake-key xy - sends the keychain <em>xy</em> :fake-key &lt;Ctrl-x&gt; - sends Ctrl-x :fake-key &lt;Escape&gt; - sends the escape key</p></div>
  1764. <div class="sect3">
  1765. <h4 id="_positional_arguments_19">positional arguments</h4>
  1766. <div class="ulist"><ul>
  1767. <li>
  1768. <p>
  1769. <code><em>keystring</em></code>: The keystring to send.
  1770. </p>
  1771. </li>
  1772. </ul></div>
  1773. </div>
  1774. <div class="sect3">
  1775. <h4 id="_optional_arguments_23">optional arguments</h4>
  1776. <div class="ulist"><ul>
  1777. <li>
  1778. <p>
  1779. <code><strong>-g</strong></code>, <code><strong>--global</strong></code>: If given, the keys are sent to the qutebrowser UI.
  1780. </p>
  1781. </li>
  1782. </ul></div>
  1783. </div>
  1784. </div>
  1785. <div class="sect2">
  1786. <h3 id="forward">forward</h3>
  1787. <div class="paragraph"><p>Syntax: <code>:forward [<strong>--tab</strong>] [<strong>--bg</strong>] [<strong>--window</strong>] [<em>index</em>]</code></p></div>
  1788. <div class="paragraph"><p>Go forward in the history of the current tab.</p></div>
  1789. <div class="sect3">
  1790. <h4 id="_positional_arguments_20">positional arguments</h4>
  1791. <div class="ulist"><ul>
  1792. <li>
  1793. <p>
  1794. <code><em>index</em></code>: Which page to go forward to, count takes precedence.
  1795. </p>
  1796. </li>
  1797. </ul></div>
  1798. </div>
  1799. <div class="sect3">
  1800. <h4 id="_optional_arguments_24">optional arguments</h4>
  1801. <div class="ulist"><ul>
  1802. <li>
  1803. <p>
  1804. <code><strong>-t</strong></code>, <code><strong>--tab</strong></code>: Go forward in a new tab.
  1805. </p>
  1806. </li>
  1807. <li>
  1808. <p>
  1809. <code><strong>-b</strong></code>, <code><strong>--bg</strong></code>: Go forward in a background tab.
  1810. </p>
  1811. </li>
  1812. <li>
  1813. <p>
  1814. <code><strong>-w</strong></code>, <code><strong>--window</strong></code>: Go forward in a new window.
  1815. </p>
  1816. </li>
  1817. </ul></div>
  1818. </div>
  1819. <div class="sect3">
  1820. <h4 id="_count_7">count</h4>
  1821. <div class="paragraph"><p>How many pages to go forward.</p></div>
  1822. </div>
  1823. </div>
  1824. <div class="sect2">
  1825. <h3 id="fullscreen">fullscreen</h3>
  1826. <div class="paragraph"><p>Syntax: <code>:fullscreen [<strong>--leave</strong>] [<strong>--enter</strong>]</code></p></div>
  1827. <div class="paragraph"><p>Toggle fullscreen mode.</p></div>
  1828. <div class="sect3">
  1829. <h4 id="_optional_arguments_25">optional arguments</h4>
  1830. <div class="ulist"><ul>
  1831. <li>
  1832. <p>
  1833. <code><strong>-l</strong></code>, <code><strong>--leave</strong></code>: Only leave fullscreen if it was entered by the page.
  1834. </p>
  1835. </li>
  1836. <li>
  1837. <p>
  1838. <code><strong>-e</strong></code>, <code><strong>--enter</strong></code>: Activate fullscreen and do not toggle if it is already active.
  1839. </p>
  1840. </li>
  1841. </ul></div>
  1842. </div>
  1843. </div>
  1844. <div class="sect2">
  1845. <h3 id="greasemonkey-reload">greasemonkey-reload</h3>
  1846. <div class="paragraph"><p>Syntax: <code>:greasemonkey-reload [<strong>--force</strong>]</code></p></div>
  1847. <div class="paragraph"><p>Re-read Greasemonkey scripts from disk.</p></div>
  1848. <div class="paragraph"><p>The scripts are read from a <em>greasemonkey</em> subdirectory in qutebrowser&#8217;s data or config directories (see <code>:version</code>).</p></div>
  1849. <div class="sect3">
  1850. <h4 id="_optional_arguments_26">optional arguments</h4>
  1851. <div class="ulist"><ul>
  1852. <li>
  1853. <p>
  1854. <code><strong>-f</strong></code>, <code><strong>--force</strong></code>: For any scripts that have required dependencies, re-download them.
  1855. </p>
  1856. </li>
  1857. </ul></div>
  1858. </div>
  1859. </div>
  1860. <div class="sect2">
  1861. <h3 id="help">help</h3>
  1862. <div class="paragraph"><p>Syntax: <code>:help [<strong>--tab</strong>] [<strong>--bg</strong>] [<strong>--window</strong>] [<em>topic</em>]</code></p></div>
  1863. <div class="paragraph"><p>Show help about a command or setting.</p></div>
  1864. <div class="sect3">
  1865. <h4 id="_positional_arguments_21">positional arguments</h4>
  1866. <div class="ulist"><ul>
  1867. <li>
  1868. <p>
  1869. <code><em>topic</em></code>: The topic to show help for.
  1870. </p>
  1871. <div class="ulist"><ul>
  1872. <li>
  1873. <p>
  1874. :<em>command</em> for commands.
  1875. </p>
  1876. </li>
  1877. <li>
  1878. <p>
  1879. <em>section</em>.<em>option</em> for settings.
  1880. </p>
  1881. </li>
  1882. </ul></div>
  1883. </li>
  1884. </ul></div>
  1885. </div>
  1886. <div class="sect3">
  1887. <h4 id="_optional_arguments_27">optional arguments</h4>
  1888. <div class="ulist"><ul>
  1889. <li>
  1890. <p>
  1891. <code><strong>-t</strong></code>, <code><strong>--tab</strong></code>: Open in a new tab.
  1892. </p>
  1893. </li>
  1894. <li>
  1895. <p>
  1896. <code><strong>-b</strong></code>, <code><strong>--bg</strong></code>: Open in a background tab.
  1897. </p>
  1898. </li>
  1899. <li>
  1900. <p>
  1901. <code><strong>-w</strong></code>, <code><strong>--window</strong></code>: Open in a new window.
  1902. </p>
  1903. </li>
  1904. </ul></div>
  1905. </div>
  1906. </div>
  1907. <div class="sect2">
  1908. <h3 id="hint">hint</h3>
  1909. <div class="paragraph"><p>Syntax: <code>:hint [<strong>--mode</strong> <em>mode</em>] [<strong>--add-history</strong>] [<strong>--rapid</strong>] [<strong>--first</strong>] [<em>group</em>] [<em>target</em>] [<em>args</em> &#8230;]</code></p></div>
  1910. <div class="paragraph"><p>Start hinting.</p></div>
  1911. <div class="sect3">
  1912. <h4 id="_positional_arguments_22">positional arguments</h4>
  1913. <div class="ulist"><ul>
  1914. <li>
  1915. <p>
  1916. <code><em>group</em></code>: The element types to hint.
  1917. </p>
  1918. <div class="ulist"><ul>
  1919. <li>
  1920. <p>
  1921. <code>all</code>: All clickable elements.
  1922. </p>
  1923. </li>
  1924. <li>
  1925. <p>
  1926. <code>links</code>: Only links.
  1927. </p>
  1928. </li>
  1929. <li>
  1930. <p>
  1931. <code>images</code>: Only images.
  1932. </p>
  1933. </li>
  1934. <li>
  1935. <p>
  1936. <code>inputs</code>: Only input fields.
  1937. </p>
  1938. <div class="literalblock">
  1939. <div class="content">
  1940. <pre><code>Custom groups can be added via the `hints.selectors` setting
  1941. and also used here.</code></pre>
  1942. </div></div>
  1943. </li>
  1944. </ul></div>
  1945. </li>
  1946. <li>
  1947. <p>
  1948. <code><em>target</em></code>: What to do with the selected element.
  1949. </p>
  1950. <div class="ulist"><ul>
  1951. <li>
  1952. <p>
  1953. <code>normal</code>: Open the link.
  1954. </p>
  1955. </li>
  1956. <li>
  1957. <p>
  1958. <code>current</code>: Open the link in the current tab.
  1959. </p>
  1960. </li>
  1961. <li>
  1962. <p>
  1963. <code>tab</code>: Open the link in a new tab (honoring the
  1964. <code>tabs.background</code> setting).
  1965. </p>
  1966. </li>
  1967. <li>
  1968. <p>
  1969. <code>tab-fg</code>: Open the link in a new foreground tab.
  1970. </p>
  1971. </li>
  1972. <li>
  1973. <p>
  1974. <code>tab-bg</code>: Open the link in a new background tab.
  1975. </p>
  1976. </li>
  1977. <li>
  1978. <p>
  1979. <code>window</code>: Open the link in a new window.
  1980. </p>
  1981. </li>
  1982. <li>
  1983. <p>
  1984. <code>hover</code> : Hover over the link.
  1985. </p>
  1986. </li>
  1987. <li>
  1988. <p>
  1989. <code>right-click</code>: Right-click the element.
  1990. </p>
  1991. </li>
  1992. <li>
  1993. <p>
  1994. <code>yank</code>: Yank the link to the clipboard.
  1995. </p>
  1996. </li>
  1997. <li>
  1998. <p>
  1999. <code>yank-primary</code>: Yank the link to the primary selection.
  2000. </p>
  2001. </li>
  2002. <li>
  2003. <p>
  2004. <code>run</code>: Run the argument as command.
  2005. </p>
  2006. </li>
  2007. <li>
  2008. <p>
  2009. <code>fill</code>: Fill the commandline with the command given as
  2010. argument.
  2011. </p>
  2012. </li>
  2013. <li>
  2014. <p>
  2015. <code>download</code>: Download the link.
  2016. </p>
  2017. </li>
  2018. <li>
  2019. <p>
  2020. <code>userscript</code>: Call a userscript with <code>$QUTE_URL</code> set to the
  2021. link.
  2022. </p>
  2023. </li>
  2024. <li>
  2025. <p>
  2026. <code>spawn</code>: Spawn a command.
  2027. </p>
  2028. </li>
  2029. <li>
  2030. <p>
  2031. <code>delete</code>: Delete the selected element.
  2032. </p>
  2033. </li>
  2034. </ul></div>
  2035. </li>
  2036. <li>
  2037. <p>
  2038. <code><em>args</em></code>: Arguments for spawn/userscript/run/fill.
  2039. </p>
  2040. <div class="ulist"><ul>
  2041. <li>
  2042. <p>
  2043. With <code>spawn</code>: The executable and arguments to spawn.
  2044. <code>{hint-url}</code> will get replaced by the selected
  2045. URL.
  2046. </p>
  2047. </li>
  2048. <li>
  2049. <p>
  2050. With <code>userscript</code>: The userscript to execute. Either store
  2051. the userscript in
  2052. <code>~/.local/share/qutebrowser/userscripts</code>
  2053. (or <code>$XDG_DATA_HOME</code>), or use an absolute
  2054. path.
  2055. </p>
  2056. </li>
  2057. <li>
  2058. <p>
  2059. With <code>fill</code>: The command to fill the statusbar with.
  2060. <code>{hint-url}</code> will get replaced by the selected
  2061. URL.
  2062. </p>
  2063. </li>
  2064. <li>
  2065. <p>
  2066. With <code>run</code>: Same as <code>fill</code>.
  2067. </p>
  2068. </li>
  2069. </ul></div>
  2070. </li>
  2071. </ul></div>
  2072. </div>
  2073. <div class="sect3">
  2074. <h4 id="_optional_arguments_28">optional arguments</h4>
  2075. <div class="ulist"><ul>
  2076. <li>
  2077. <p>
  2078. <code><strong>-m</strong></code>, <code><strong>--mode</strong></code>: The hinting mode to use.
  2079. </p>
  2080. <div class="ulist"><ul>
  2081. <li>
  2082. <p>
  2083. <code>number</code>: Use numeric hints.
  2084. </p>
  2085. </li>
  2086. <li>
  2087. <p>
  2088. <code>letter</code>: Use the chars in the hints.chars setting.
  2089. </p>
  2090. </li>
  2091. <li>
  2092. <p>
  2093. <code>word</code>: Use hint words based on the html elements and the
  2094. extra words.
  2095. </p>
  2096. </li>
  2097. </ul></div>
  2098. </li>
  2099. <li>
  2100. <p>
  2101. <code><strong>-a</strong></code>, <code><strong>--add-history</strong></code>: Whether to add the spawned or yanked link to the browsing history.
  2102. </p>
  2103. </li>
  2104. <li>
  2105. <p>
  2106. <code><strong>-r</strong></code>, <code><strong>--rapid</strong></code>: Whether to do rapid hinting. With rapid hinting, the hint mode isn&#8217;t left after a hint is followed, so you can easily
  2107. open multiple links. This is only possible with targets
  2108. <code>tab</code> (with <code>tabs.background=true</code>), <code>tab-bg</code>,
  2109. <code>window</code>, <code>run</code>, <code>hover</code>, <code>userscript</code> and <code>spawn</code>.
  2110. </p>
  2111. </li>
  2112. <li>
  2113. <p>
  2114. <code><strong>-f</strong></code>, <code><strong>--first</strong></code>: Click the first hinted element without prompting.
  2115. </p>
  2116. </li>
  2117. </ul></div>
  2118. </div>
  2119. <div class="sect3">
  2120. <h4 id="_note_5">note</h4>
  2121. <div class="ulist"><ul>
  2122. <li>
  2123. <p>
  2124. This command does not split arguments after the last argument and handles quotes literally.
  2125. </p>
  2126. </li>
  2127. </ul></div>
  2128. </div>
  2129. </div>
  2130. <div class="sect2">
  2131. <h3 id="history">history</h3>
  2132. <div class="paragraph"><p>Syntax: <code>:history [<strong>--tab</strong>] [<strong>--bg</strong>] [<strong>--window</strong>]</code></p></div>
  2133. <div class="paragraph"><p>Show browsing history.</p></div>
  2134. <div class="sect3">
  2135. <h4 id="_optional_arguments_29">optional arguments</h4>
  2136. <div class="ulist"><ul>
  2137. <li>
  2138. <p>
  2139. <code><strong>-t</strong></code>, <code><strong>--tab</strong></code>: Open in a new tab.
  2140. </p>
  2141. </li>
  2142. <li>
  2143. <p>
  2144. <code><strong>-b</strong></code>, <code><strong>--bg</strong></code>: Open in a background tab.
  2145. </p>
  2146. </li>
  2147. <li>
  2148. <p>
  2149. <code><strong>-w</strong></code>, <code><strong>--window</strong></code>: Open in a new window.
  2150. </p>
  2151. </li>
  2152. </ul></div>
  2153. </div>
  2154. </div>
  2155. <div class="sect2">
  2156. <h3 id="history-clear">history-clear</h3>
  2157. <div class="paragraph"><p>Syntax: <code>:history-clear [<strong>--force</strong>]</code></p></div>
  2158. <div class="paragraph"><p>Clear all browsing history.</p></div>
  2159. <div class="paragraph"><p>Note this only clears the global history (e.g. <code>~/.local/share/qutebrowser/history</code> on Linux) but not cookies, the back/forward history of a tab, cache or other persistent data.</p></div>
  2160. <div class="sect3">
  2161. <h4 id="_optional_arguments_30">optional arguments</h4>
  2162. <div class="ulist"><ul>
  2163. <li>
  2164. <p>
  2165. <code><strong>-f</strong></code>, <code><strong>--force</strong></code>: Don&#8217;t ask for confirmation.
  2166. </p>
  2167. </li>
  2168. </ul></div>
  2169. </div>
  2170. </div>
  2171. <div class="sect2">
  2172. <h3 id="home">home</h3>
  2173. <div class="paragraph"><p>Open main startpage in current tab.</p></div>
  2174. </div>
  2175. <div class="sect2">
  2176. <h3 id="insert-text">insert-text</h3>
  2177. <div class="paragraph"><p>Syntax: <code>:insert-text <em>text</em></code></p></div>
  2178. <div class="paragraph"><p>Insert text at cursor position.</p></div>
  2179. <div class="sect3">
  2180. <h4 id="_positional_arguments_23">positional arguments</h4>
  2181. <div class="ulist"><ul>
  2182. <li>
  2183. <p>
  2184. <code><em>text</em></code>: The text to insert.
  2185. </p>
  2186. </li>
  2187. </ul></div>
  2188. </div>
  2189. <div class="sect3">
  2190. <h4 id="_note_6">note</h4>
  2191. <div class="ulist"><ul>
  2192. <li>
  2193. <p>
  2194. This command does not split arguments after the last argument and handles quotes literally.
  2195. </p>
  2196. </li>
  2197. </ul></div>
  2198. </div>
  2199. </div>
  2200. <div class="sect2">
  2201. <h3 id="jseval">jseval</h3>
  2202. <div class="paragraph"><p>Syntax: <code>:jseval [<strong>--file</strong>] [<strong>--url</strong>] [<strong>--quiet</strong>] [<strong>--world</strong> <em>world</em>] <em>js-code</em></code></p></div>
  2203. <div class="paragraph"><p>Evaluate a JavaScript string.</p></div>
  2204. <div class="sect3">
  2205. <h4 id="_positional_arguments_24">positional arguments</h4>
  2206. <div class="ulist"><ul>
  2207. <li>
  2208. <p>
  2209. <code><em>js-code</em></code>: The string/file to evaluate.
  2210. </p>
  2211. </li>
  2212. </ul></div>
  2213. </div>
  2214. <div class="sect3">
  2215. <h4 id="_optional_arguments_31">optional arguments</h4>
  2216. <div class="ulist"><ul>
  2217. <li>
  2218. <p>
  2219. <code><strong>-f</strong></code>, <code><strong>--file</strong></code>: Interpret js-code as a path to a file. If the path is relative, the file is searched in a js/ subdir
  2220. in qutebrowser&#8217;s data dir, e.g.
  2221. <code>~/.local/share/qutebrowser/js</code>.
  2222. </p>
  2223. </li>
  2224. <li>
  2225. <p>
  2226. <code><strong>-u</strong></code>, <code><strong>--url</strong></code>: Interpret js-code as a <code>javascript:...</code> URL.
  2227. </p>
  2228. </li>
  2229. <li>
  2230. <p>
  2231. <code><strong>-q</strong></code>, <code><strong>--quiet</strong></code>: Don&#8217;t show resulting JS object.
  2232. </p>
  2233. </li>
  2234. <li>
  2235. <p>
  2236. <code><strong>-w</strong></code>, <code><strong>--world</strong></code>: Ignored on QtWebKit. On QtWebEngine, a world ID or name to run the snippet in. Predefined world names are:
  2237. </p>
  2238. <div class="ulist"><ul>
  2239. <li>
  2240. <p>
  2241. <code>main</code> (same world as the web page&#8217;s JavaScript and
  2242. Greasemonkey, unless overridden via <code>@qute-js-world</code>)
  2243. </p>
  2244. </li>
  2245. <li>
  2246. <p>
  2247. <code>application</code> (used for internal qutebrowser JS code,
  2248. should not be used via <code>:jseval</code> unless you know what
  2249. you&#8217;re doing)
  2250. </p>
  2251. </li>
  2252. <li>
  2253. <p>
  2254. <code>user</code> (currently unused)
  2255. </p>
  2256. </li>
  2257. <li>
  2258. <p>
  2259. <code>jseval</code> (used for this command by default)
  2260. </p>
  2261. </li>
  2262. </ul></div>
  2263. </li>
  2264. </ul></div>
  2265. </div>
  2266. <div class="sect3">
  2267. <h4 id="_note_7">note</h4>
  2268. <div class="ulist"><ul>
  2269. <li>
  2270. <p>
  2271. This command does not split arguments after the last argument and handles quotes literally.
  2272. </p>
  2273. </li>
  2274. <li>
  2275. <p>
  2276. With this command, <code>;;</code> is interpreted literally instead of splitting off a second command.
  2277. </p>
  2278. </li>
  2279. </ul></div>
  2280. </div>
  2281. </div>
  2282. <div class="sect2">
  2283. <h3 id="jump-mark">jump-mark</h3>
  2284. <div class="paragraph"><p>Syntax: <code>:jump-mark <em>key</em></code></p></div>
  2285. <div class="paragraph"><p>Jump to the mark named by <code>key</code>.</p></div>
  2286. <div class="sect3">
  2287. <h4 id="_positional_arguments_25">positional arguments</h4>
  2288. <div class="ulist"><ul>
  2289. <li>
  2290. <p>
  2291. <code><em>key</em></code>: mark identifier; capital indicates a global mark
  2292. </p>
  2293. </li>
  2294. </ul></div>
  2295. </div>
  2296. </div>
  2297. <div class="sect2">
  2298. <h3 id="later">later</h3>
  2299. <div class="paragraph"><p>Syntax: <code>:later <em>duration</em> <em>command</em></code></p></div>
  2300. <div class="paragraph"><p>Execute a command after some time.</p></div>
  2301. <div class="sect3">
  2302. <h4 id="_positional_arguments_26">positional arguments</h4>
  2303. <div class="ulist"><ul>
  2304. <li>
  2305. <p>
  2306. <code><em>duration</em></code>: Duration to wait in format XhYmZs or a number for milliseconds.
  2307. </p>
  2308. </li>
  2309. <li>
  2310. <p>
  2311. <code><em>command</em></code>: The command to run, with optional args.
  2312. </p>
  2313. </li>
  2314. </ul></div>
  2315. </div>
  2316. <div class="sect3">
  2317. <h4 id="_note_8">note</h4>
  2318. <div class="ulist"><ul>
  2319. <li>
  2320. <p>
  2321. This command does not split arguments after the last argument and handles quotes literally.
  2322. </p>
  2323. </li>
  2324. <li>
  2325. <p>
  2326. With this command, <code>;;</code> is interpreted literally instead of splitting off a second command.
  2327. </p>
  2328. </li>
  2329. <li>
  2330. <p>
  2331. This command does not replace variables like <code>{url}</code>.
  2332. </p>
  2333. </li>
  2334. </ul></div>
  2335. </div>
  2336. </div>
  2337. <div class="sect2">
  2338. <h3 id="macro-record">macro-record</h3>
  2339. <div class="paragraph"><p>Syntax: <code>:macro-record [<em>register</em>]</code></p></div>
  2340. <div class="paragraph"><p>Start or stop recording a macro.</p></div>
  2341. <div class="sect3">
  2342. <h4 id="_positional_arguments_27">positional arguments</h4>
  2343. <div class="ulist"><ul>
  2344. <li>
  2345. <p>
  2346. <code><em>register</em></code>: Which register to store the macro in.
  2347. </p>
  2348. </li>
  2349. </ul></div>
  2350. </div>
  2351. </div>
  2352. <div class="sect2">
  2353. <h3 id="macro-run">macro-run</h3>
  2354. <div class="paragraph"><p>Syntax: <code>:macro-run [<em>register</em>]</code></p></div>
  2355. <div class="paragraph"><p>Run a recorded macro.</p></div>
  2356. <div class="sect3">
  2357. <h4 id="_positional_arguments_28">positional arguments</h4>
  2358. <div class="ulist"><ul>
  2359. <li>
  2360. <p>
  2361. <code><em>register</em></code>: Which macro to run.
  2362. </p>
  2363. </li>
  2364. </ul></div>
  2365. </div>
  2366. <div class="sect3">
  2367. <h4 id="_count_8">count</h4>
  2368. <div class="paragraph"><p>How many times to run the macro.</p></div>
  2369. </div>
  2370. </div>
  2371. <div class="sect2">
  2372. <h3 id="message-error">message-error</h3>
  2373. <div class="paragraph"><p>Syntax: <code>:message-error <em>text</em></code></p></div>
  2374. <div class="paragraph"><p>Show an error message in the statusbar.</p></div>
  2375. <div class="sect3">
  2376. <h4 id="_positional_arguments_29">positional arguments</h4>
  2377. <div class="ulist"><ul>
  2378. <li>
  2379. <p>
  2380. <code><em>text</em></code>: The text to show.
  2381. </p>
  2382. </li>
  2383. </ul></div>
  2384. </div>
  2385. </div>
  2386. <div class="sect2">
  2387. <h3 id="message-info">message-info</h3>
  2388. <div class="paragraph"><p>Syntax: <code>:message-info <em>text</em></code></p></div>
  2389. <div class="paragraph"><p>Show an info message in the statusbar.</p></div>
  2390. <div class="sect3">
  2391. <h4 id="_positional_arguments_30">positional arguments</h4>
  2392. <div class="ulist"><ul>
  2393. <li>
  2394. <p>
  2395. <code><em>text</em></code>: The text to show.
  2396. </p>
  2397. </li>
  2398. </ul></div>
  2399. </div>
  2400. <div class="sect3">
  2401. <h4 id="_count_9">count</h4>
  2402. <div class="paragraph"><p>How many times to show the message</p></div>
  2403. </div>
  2404. </div>
  2405. <div class="sect2">
  2406. <h3 id="message-warning">message-warning</h3>
  2407. <div class="paragraph"><p>Syntax: <code>:message-warning <em>text</em></code></p></div>
  2408. <div class="paragraph"><p>Show a warning message in the statusbar.</p></div>
  2409. <div class="sect3">
  2410. <h4 id="_positional_arguments_31">positional arguments</h4>
  2411. <div class="ulist"><ul>
  2412. <li>
  2413. <p>
  2414. <code><em>text</em></code>: The text to show.
  2415. </p>
  2416. </li>
  2417. </ul></div>
  2418. </div>
  2419. </div>
  2420. <div class="sect2">
  2421. <h3 id="messages">messages</h3>
  2422. <div class="paragraph"><p>Syntax: <code>:messages [<strong>--plain</strong>] [<strong>--tab</strong>] [<strong>--bg</strong>] [<strong>--window</strong>] [<strong>--logfilter</strong> <em>logfilter</em>] [<em>level</em>]</code></p></div>
  2423. <div class="paragraph"><p>Show a log of past messages.</p></div>
  2424. <div class="sect3">
  2425. <h4 id="_positional_arguments_32">positional arguments</h4>
  2426. <div class="ulist"><ul>
  2427. <li>
  2428. <p>
  2429. <code><em>level</em></code>: Include messages with <code>level</code> or higher severity. Valid values: vdebug, debug, info, warning, error, critical.
  2430. </p>
  2431. </li>
  2432. </ul></div>
  2433. </div>
  2434. <div class="sect3">
  2435. <h4 id="_optional_arguments_32">optional arguments</h4>
  2436. <div class="ulist"><ul>
  2437. <li>
  2438. <p>
  2439. <code><strong>-p</strong></code>, <code><strong>--plain</strong></code>: Whether to show plaintext (as opposed to html).
  2440. </p>
  2441. </li>
  2442. <li>
  2443. <p>
  2444. <code><strong>-t</strong></code>, <code><strong>--tab</strong></code>: Open in a new tab.
  2445. </p>
  2446. </li>
  2447. <li>
  2448. <p>
  2449. <code><strong>-b</strong></code>, <code><strong>--bg</strong></code>: Open in a background tab.
  2450. </p>
  2451. </li>
  2452. <li>
  2453. <p>
  2454. <code><strong>-w</strong></code>, <code><strong>--window</strong></code>: Open in a new window.
  2455. </p>
  2456. </li>
  2457. <li>
  2458. <p>
  2459. <code><strong>-f</strong></code>, <code><strong>--logfilter</strong></code>: A comma-separated filter string of logging categories. If the filter string starts with an exclamation mark, it
  2460. is negated.
  2461. </p>
  2462. </li>
  2463. </ul></div>
  2464. </div>
  2465. </div>
  2466. <div class="sect2">
  2467. <h3 id="mode-enter">mode-enter</h3>
  2468. <div class="paragraph"><p>Syntax: <code>:mode-enter <em>mode</em></code></p></div>
  2469. <div class="paragraph"><p>Enter a key mode.</p></div>
  2470. <div class="sect3">
  2471. <h4 id="_positional_arguments_33">positional arguments</h4>
  2472. <div class="ulist"><ul>
  2473. <li>
  2474. <p>
  2475. <code><em>mode</em></code>: The mode to enter. See <code>:help bindings.commands</code> for the available modes, but note that hint/command/yesno/prompt mode
  2476. can&#8217;t be entered manually.
  2477. </p>
  2478. </li>
  2479. </ul></div>
  2480. </div>
  2481. </div>
  2482. <div class="sect2">
  2483. <h3 id="navigate">navigate</h3>
  2484. <div class="paragraph"><p>Syntax: <code>:navigate [<strong>--tab</strong>] [<strong>--bg</strong>] [<strong>--window</strong>] <em>where</em></code></p></div>
  2485. <div class="paragraph"><p>Open typical prev/next links or navigate using the URL path.</p></div>
  2486. <div class="paragraph"><p>This tries to automatically click on typical <em>Previous Page</em> or <em>Next Page</em> links using some heuristics. Alternatively it can navigate by changing the current URL.</p></div>
  2487. <div class="sect3">
  2488. <h4 id="_positional_arguments_34">positional arguments</h4>
  2489. <div class="ulist"><ul>
  2490. <li>
  2491. <p>
  2492. <code><em>where</em></code>: What to open.
  2493. </p>
  2494. <div class="ulist"><ul>
  2495. <li>
  2496. <p>
  2497. <code>prev</code>: Open a <em>previous</em> link.
  2498. </p>
  2499. </li>
  2500. <li>
  2501. <p>
  2502. <code>next</code>: Open a <em>next</em> link.
  2503. </p>
  2504. </li>
  2505. <li>
  2506. <p>
  2507. <code>up</code>: Go up a level in the current URL.
  2508. </p>
  2509. </li>
  2510. <li>
  2511. <p>
  2512. <code>increment</code>: Increment the last number in the URL.
  2513. Uses the
  2514. config option.
  2515. </p>
  2516. </li>
  2517. <li>
  2518. <p>
  2519. <code>decrement</code>: Decrement the last number in the URL.
  2520. Uses the
  2521. config option.
  2522. </p>
  2523. </li>
  2524. <li>
  2525. <p>
  2526. <code>strip</code>: Strip query and fragment from the current URL.
  2527. </p>
  2528. </li>
  2529. </ul></div>
  2530. </li>
  2531. </ul></div>
  2532. </div>
  2533. <div class="sect3">
  2534. <h4 id="_optional_arguments_33">optional arguments</h4>
  2535. <div class="ulist"><ul>
  2536. <li>
  2537. <p>
  2538. <code><strong>-t</strong></code>, <code><strong>--tab</strong></code>: Open in a new tab.
  2539. </p>
  2540. </li>
  2541. <li>
  2542. <p>
  2543. <code><strong>-b</strong></code>, <code><strong>--bg</strong></code>: Open in a background tab.
  2544. </p>
  2545. </li>
  2546. <li>
  2547. <p>
  2548. <code><strong>-w</strong></code>, <code><strong>--window</strong></code>: Open in a new window.
  2549. </p>
  2550. </li>
  2551. </ul></div>
  2552. </div>
  2553. <div class="sect3">
  2554. <h4 id="_count_10">count</h4>
  2555. <div class="paragraph"><p>For <code>increment</code> and <code>decrement</code>, the number to change the URL by. For <code>up</code>, the number of levels to go up in the URL.</p></div>
  2556. </div>
  2557. </div>
  2558. <div class="sect2">
  2559. <h3 id="nop">nop</h3>
  2560. <div class="paragraph"><p>Do nothing.</p></div>
  2561. </div>
  2562. <div class="sect2">
  2563. <h3 id="open">open</h3>
  2564. <div class="paragraph"><p>Syntax: <code>:open [<strong>--related</strong>] [<strong>--bg</strong>] [<strong>--tab</strong>] [<strong>--window</strong>] [<strong>--secure</strong>] [<strong>--private</strong>] [<em>url</em>]</code></p></div>
  2565. <div class="paragraph"><p>Open a URL in the current/[count]th tab.</p></div>
  2566. <div class="paragraph"><p>If the URL contains newlines, each line gets opened in its own tab.</p></div>
  2567. <div class="sect3">
  2568. <h4 id="_positional_arguments_35">positional arguments</h4>
  2569. <div class="ulist"><ul>
  2570. <li>
  2571. <p>
  2572. <code><em>url</em></code>: The URL to open.
  2573. </p>
  2574. </li>
  2575. </ul></div>
  2576. </div>
  2577. <div class="sect3">
  2578. <h4 id="_optional_arguments_34">optional arguments</h4>
  2579. <div class="ulist"><ul>
  2580. <li>
  2581. <p>
  2582. <code><strong>-r</strong></code>, <code><strong>--related</strong></code>: If opening a new tab, position the tab as related to the current one (like clicking on a link).
  2583. </p>
  2584. </li>
  2585. <li>
  2586. <p>
  2587. <code><strong>-b</strong></code>, <code><strong>--bg</strong></code>: Open in a new background tab.
  2588. </p>
  2589. </li>
  2590. <li>
  2591. <p>
  2592. <code><strong>-t</strong></code>, <code><strong>--tab</strong></code>: Open in a new tab.
  2593. </p>
  2594. </li>
  2595. <li>
  2596. <p>
  2597. <code><strong>-w</strong></code>, <code><strong>--window</strong></code>: Open in a new window.
  2598. </p>
  2599. </li>
  2600. <li>
  2601. <p>
  2602. <code><strong>-s</strong></code>, <code><strong>--secure</strong></code>: Force HTTPS.
  2603. </p>
  2604. </li>
  2605. <li>
  2606. <p>
  2607. <code><strong>-p</strong></code>, <code><strong>--private</strong></code>: Open a new window in private browsing mode.
  2608. </p>
  2609. </li>
  2610. </ul></div>
  2611. </div>
  2612. <div class="sect3">
  2613. <h4 id="_count_11">count</h4>
  2614. <div class="paragraph"><p>The tab index to open the URL in.</p></div>
  2615. </div>
  2616. <div class="sect3">
  2617. <h4 id="_note_9">note</h4>
  2618. <div class="ulist"><ul>
  2619. <li>
  2620. <p>
  2621. This command does not split arguments after the last argument and handles quotes literally.
  2622. </p>
  2623. </li>
  2624. </ul></div>
  2625. </div>
  2626. </div>
  2627. <div class="sect2">
  2628. <h3 id="print">print</h3>
  2629. <div class="paragraph"><p>Syntax: <code>:print [<strong>--preview</strong>] [<strong>--pdf</strong> <em>file</em>]</code></p></div>
  2630. <div class="paragraph"><p>Print the current/[count]th tab.</p></div>
  2631. <div class="sect3">
  2632. <h4 id="_optional_arguments_35">optional arguments</h4>
  2633. <div class="ulist"><ul>
  2634. <li>
  2635. <p>
  2636. <code><strong>-p</strong></code>, <code><strong>--preview</strong></code>: Show preview instead of printing.
  2637. </p>
  2638. </li>
  2639. <li>
  2640. <p>
  2641. <code><strong>-f</strong></code>, <code><strong>--pdf</strong></code>: The file path to write the PDF to.
  2642. </p>
  2643. </li>
  2644. </ul></div>
  2645. </div>
  2646. <div class="sect3">
  2647. <h4 id="_count_12">count</h4>
  2648. <div class="paragraph"><p>The tab index to print.</p></div>
  2649. </div>
  2650. </div>
  2651. <div class="sect2">
  2652. <h3 id="process">process</h3>
  2653. <div class="paragraph"><p>Syntax: <code>:process [<em>pid</em>] [<em>action</em>]</code></p></div>
  2654. <div class="paragraph"><p>Manage processes spawned by qutebrowser.</p></div>
  2655. <div class="paragraph"><p>Note that processes with a successful exit get cleaned up after 1h.</p></div>
  2656. <div class="sect3">
  2657. <h4 id="_positional_arguments_36">positional arguments</h4>
  2658. <div class="ulist"><ul>
  2659. <li>
  2660. <p>
  2661. <code><em>pid</em></code>: The process ID of the process to manage.
  2662. </p>
  2663. </li>
  2664. <li>
  2665. <p>
  2666. <code><em>action</em></code>: What to do with the given process:
  2667. </p>
  2668. <div class="ulist"><ul>
  2669. <li>
  2670. <p>
  2671. show: Show information about the process.
  2672. </p>
  2673. </li>
  2674. <li>
  2675. <p>
  2676. terminate: Try to gracefully terminate the process (SIGTERM).
  2677. </p>
  2678. </li>
  2679. <li>
  2680. <p>
  2681. kill: Kill the process forcefully (SIGKILL).
  2682. </p>
  2683. </li>
  2684. </ul></div>
  2685. </li>
  2686. </ul></div>
  2687. </div>
  2688. </div>
  2689. <div class="sect2">
  2690. <h3 id="quickmark-add">quickmark-add</h3>
  2691. <div class="paragraph"><p>Syntax: <code>:quickmark-add <em>url</em> <em>name</em></code></p></div>
  2692. <div class="paragraph"><p>Add a new quickmark.</p></div>
  2693. <div class="paragraph"><p>You can view all saved quickmarks on the <a href="qute://bookmarks">bookmarks page</a>.</p></div>
  2694. <div class="sect3">
  2695. <h4 id="_positional_arguments_37">positional arguments</h4>
  2696. <div class="ulist"><ul>
  2697. <li>
  2698. <p>
  2699. <code><em>url</em></code>: The url to add as quickmark.
  2700. </p>
  2701. </li>
  2702. <li>
  2703. <p>
  2704. <code><em>name</em></code>: The name for the new quickmark.
  2705. </p>
  2706. </li>
  2707. </ul></div>
  2708. </div>
  2709. </div>
  2710. <div class="sect2">
  2711. <h3 id="quickmark-del">quickmark-del</h3>
  2712. <div class="paragraph"><p>Syntax: <code>:quickmark-del [<em>name</em>]</code></p></div>
  2713. <div class="paragraph"><p>Delete a quickmark.</p></div>
  2714. <div class="sect3">
  2715. <h4 id="_positional_arguments_38">positional arguments</h4>
  2716. <div class="ulist"><ul>
  2717. <li>
  2718. <p>
  2719. <code><em>name</em></code>: The name of the quickmark to delete. If not given, delete the quickmark for the current page (choosing one arbitrarily
  2720. if there are more than one).
  2721. </p>
  2722. </li>
  2723. </ul></div>
  2724. </div>
  2725. <div class="sect3">
  2726. <h4 id="_note_10">note</h4>
  2727. <div class="ulist"><ul>
  2728. <li>
  2729. <p>
  2730. This command does not split arguments after the last argument and handles quotes literally.
  2731. </p>
  2732. </li>
  2733. </ul></div>
  2734. </div>
  2735. </div>
  2736. <div class="sect2">
  2737. <h3 id="quickmark-load">quickmark-load</h3>
  2738. <div class="paragraph"><p>Syntax: <code>:quickmark-load [<strong>--tab</strong>] [<strong>--bg</strong>] [<strong>--window</strong>] <em>name</em></code></p></div>
  2739. <div class="paragraph"><p>Load a quickmark.</p></div>
  2740. <div class="sect3">
  2741. <h4 id="_positional_arguments_39">positional arguments</h4>
  2742. <div class="ulist"><ul>
  2743. <li>
  2744. <p>
  2745. <code><em>name</em></code>: The name of the quickmark to load.
  2746. </p>
  2747. </li>
  2748. </ul></div>
  2749. </div>
  2750. <div class="sect3">
  2751. <h4 id="_optional_arguments_36">optional arguments</h4>
  2752. <div class="ulist"><ul>
  2753. <li>
  2754. <p>
  2755. <code><strong>-t</strong></code>, <code><strong>--tab</strong></code>: Load the quickmark in a new tab.
  2756. </p>
  2757. </li>
  2758. <li>
  2759. <p>
  2760. <code><strong>-b</strong></code>, <code><strong>--bg</strong></code>: Load the quickmark in a new background tab.
  2761. </p>
  2762. </li>
  2763. <li>
  2764. <p>
  2765. <code><strong>-w</strong></code>, <code><strong>--window</strong></code>: Load the quickmark in a new window.
  2766. </p>
  2767. </li>
  2768. </ul></div>
  2769. </div>
  2770. <div class="sect3">
  2771. <h4 id="_note_11">note</h4>
  2772. <div class="ulist"><ul>
  2773. <li>
  2774. <p>
  2775. This command does not split arguments after the last argument and handles quotes literally.
  2776. </p>
  2777. </li>
  2778. </ul></div>
  2779. </div>
  2780. </div>
  2781. <div class="sect2">
  2782. <h3 id="quickmark-save">quickmark-save</h3>
  2783. <div class="paragraph"><p>Save the current page as a quickmark.</p></div>
  2784. </div>
  2785. <div class="sect2">
  2786. <h3 id="quit">quit</h3>
  2787. <div class="paragraph"><p>Syntax: <code>:quit [<strong>--save</strong>] [<em>session</em>]</code></p></div>
  2788. <div class="paragraph"><p>Quit qutebrowser.</p></div>
  2789. <div class="sect3">
  2790. <h4 id="_positional_arguments_40">positional arguments</h4>
  2791. <div class="ulist"><ul>
  2792. <li>
  2793. <p>
  2794. <code><em>session</em></code>: The name of the session to save.
  2795. </p>
  2796. </li>
  2797. </ul></div>
  2798. </div>
  2799. <div class="sect3">
  2800. <h4 id="_optional_arguments_37">optional arguments</h4>
  2801. <div class="ulist"><ul>
  2802. <li>
  2803. <p>
  2804. <code><strong>-s</strong></code>, <code><strong>--save</strong></code>: When given, save the open windows even if auto_save.session is turned off.
  2805. </p>
  2806. </li>
  2807. </ul></div>
  2808. </div>
  2809. </div>
  2810. <div class="sect2">
  2811. <h3 id="reload">reload</h3>
  2812. <div class="paragraph"><p>Syntax: <code>:reload [<strong>--force</strong>]</code></p></div>
  2813. <div class="paragraph"><p>Reload the current/[count]th tab.</p></div>
  2814. <div class="sect3">
  2815. <h4 id="_optional_arguments_38">optional arguments</h4>
  2816. <div class="ulist"><ul>
  2817. <li>
  2818. <p>
  2819. <code><strong>-f</strong></code>, <code><strong>--force</strong></code>: Bypass the page cache.
  2820. </p>
  2821. </li>
  2822. </ul></div>
  2823. </div>
  2824. <div class="sect3">
  2825. <h4 id="_count_13">count</h4>
  2826. <div class="paragraph"><p>The tab index to reload.</p></div>
  2827. </div>
  2828. </div>
  2829. <div class="sect2">
  2830. <h3 id="repeat">repeat</h3>
  2831. <div class="paragraph"><p>Syntax: <code>:repeat <em>times</em> <em>command</em></code></p></div>
  2832. <div class="paragraph"><p>Repeat a given command.</p></div>
  2833. <div class="sect3">
  2834. <h4 id="_positional_arguments_41">positional arguments</h4>
  2835. <div class="ulist"><ul>
  2836. <li>
  2837. <p>
  2838. <code><em>times</em></code>: How many times to repeat.
  2839. </p>
  2840. </li>
  2841. <li>
  2842. <p>
  2843. <code><em>command</em></code>: The command to run, with optional args.
  2844. </p>
  2845. </li>
  2846. </ul></div>
  2847. </div>
  2848. <div class="sect3">
  2849. <h4 id="_count_14">count</h4>
  2850. <div class="paragraph"><p>Multiplies with <em>times</em> when given.</p></div>
  2851. </div>
  2852. <div class="sect3">
  2853. <h4 id="_note_12">note</h4>
  2854. <div class="ulist"><ul>
  2855. <li>
  2856. <p>
  2857. This command does not split arguments after the last argument and handles quotes literally.
  2858. </p>
  2859. </li>
  2860. <li>
  2861. <p>
  2862. With this command, <code>;;</code> is interpreted literally instead of splitting off a second command.
  2863. </p>
  2864. </li>
  2865. <li>
  2866. <p>
  2867. This command does not replace variables like <code>{url}</code>.
  2868. </p>
  2869. </li>
  2870. </ul></div>
  2871. </div>
  2872. </div>
  2873. <div class="sect2">
  2874. <h3 id="repeat-command">repeat-command</h3>
  2875. <div class="paragraph"><p>Repeat the last executed command.</p></div>
  2876. <div class="sect3">
  2877. <h4 id="_count_15">count</h4>
  2878. <div class="paragraph"><p>Which count to pass the command.</p></div>
  2879. </div>
  2880. </div>
  2881. <div class="sect2">
  2882. <h3 id="report">report</h3>
  2883. <div class="paragraph"><p>Syntax: <code>:report [<em>info</em>] [<em>contact</em>]</code></p></div>
  2884. <div class="paragraph"><p>Report a bug in qutebrowser.</p></div>
  2885. <div class="sect3">
  2886. <h4 id="_positional_arguments_42">positional arguments</h4>
  2887. <div class="ulist"><ul>
  2888. <li>
  2889. <p>
  2890. <code><em>info</em></code>: Information about the bug report. If given, no report dialog shows up.
  2891. </p>
  2892. </li>
  2893. <li>
  2894. <p>
  2895. <code><em>contact</em></code>: Contact information for the report.
  2896. </p>
  2897. </li>
  2898. </ul></div>
  2899. </div>
  2900. </div>
  2901. <div class="sect2">
  2902. <h3 id="restart">restart</h3>
  2903. <div class="paragraph"><p>Restart qutebrowser while keeping existing tabs open.</p></div>
  2904. </div>
  2905. <div class="sect2">
  2906. <h3 id="run-with-count">run-with-count</h3>
  2907. <div class="paragraph"><p>Syntax: <code>:run-with-count <em>count-arg</em> <em>command</em></code></p></div>
  2908. <div class="paragraph"><p>Run a command with the given count.</p></div>
  2909. <div class="paragraph"><p>If run_with_count itself is run with a count, it multiplies count_arg.</p></div>
  2910. <div class="sect3">
  2911. <h4 id="_positional_arguments_43">positional arguments</h4>
  2912. <div class="ulist"><ul>
  2913. <li>
  2914. <p>
  2915. <code><em>count-arg</em></code>: The count to pass to the command.
  2916. </p>
  2917. </li>
  2918. <li>
  2919. <p>
  2920. <code><em>command</em></code>: The command to run, with optional args.
  2921. </p>
  2922. </li>
  2923. </ul></div>
  2924. </div>
  2925. <div class="sect3">
  2926. <h4 id="_count_16">count</h4>
  2927. <div class="paragraph"><p>The count that run_with_count itself received.</p></div>
  2928. </div>
  2929. <div class="sect3">
  2930. <h4 id="_note_13">note</h4>
  2931. <div class="ulist"><ul>
  2932. <li>
  2933. <p>
  2934. This command does not split arguments after the last argument and handles quotes literally.
  2935. </p>
  2936. </li>
  2937. <li>
  2938. <p>
  2939. With this command, <code>;;</code> is interpreted literally instead of splitting off a second command.
  2940. </p>
  2941. </li>
  2942. <li>
  2943. <p>
  2944. This command does not replace variables like <code>{url}</code>.
  2945. </p>
  2946. </li>
  2947. </ul></div>
  2948. </div>
  2949. </div>
  2950. <div class="sect2">
  2951. <h3 id="save">save</h3>
  2952. <div class="paragraph"><p>Syntax: <code>:save [<em>what</em> &#8230;]</code></p></div>
  2953. <div class="paragraph"><p>Save configs and state.</p></div>
  2954. <div class="sect3">
  2955. <h4 id="_positional_arguments_44">positional arguments</h4>
  2956. <div class="ulist"><ul>
  2957. <li>
  2958. <p>
  2959. <code><em>what</em></code>: What to save (<code>config</code>/<code>key-config</code>/<code>cookies</code>/&#8230;). If not given, everything is saved.
  2960. </p>
  2961. </li>
  2962. </ul></div>
  2963. </div>
  2964. </div>
  2965. <div class="sect2">
  2966. <h3 id="screenshot">screenshot</h3>
  2967. <div class="paragraph"><p>Syntax: <code>:screenshot [<strong>--rect</strong> <em>rect</em>] [<strong>--force</strong>] <em>filename</em></code></p></div>
  2968. <div class="paragraph"><p>Take a screenshot of the currently shown part of the page.</p></div>
  2969. <div class="paragraph"><p>The file format is automatically determined based on the given file extension.</p></div>
  2970. <div class="sect3">
  2971. <h4 id="_positional_arguments_45">positional arguments</h4>
  2972. <div class="ulist"><ul>
  2973. <li>
  2974. <p>
  2975. <code><em>filename</em></code>: The file to save the screenshot to (~ gets expanded).
  2976. </p>
  2977. </li>
  2978. </ul></div>
  2979. </div>
  2980. <div class="sect3">
  2981. <h4 id="_optional_arguments_39">optional arguments</h4>
  2982. <div class="ulist"><ul>
  2983. <li>
  2984. <p>
  2985. <code><strong>-r</strong></code>, <code><strong>--rect</strong></code>: The rectangle to save, as a string like WxH+X+Y.
  2986. </p>
  2987. </li>
  2988. <li>
  2989. <p>
  2990. <code><strong>-f</strong></code>, <code><strong>--force</strong></code>: Overwrite existing files.
  2991. </p>
  2992. </li>
  2993. </ul></div>
  2994. </div>
  2995. </div>
  2996. <div class="sect2">
  2997. <h3 id="scroll">scroll</h3>
  2998. <div class="paragraph"><p>Syntax: <code>:scroll <em>direction</em></code></p></div>
  2999. <div class="paragraph"><p>Scroll the current tab in the given direction.</p></div>
  3000. <div class="paragraph"><p>Note you can use <code>:run-with-count</code> to have a keybinding with a bigger scroll increment.</p></div>
  3001. <div class="sect3">
  3002. <h4 id="_positional_arguments_46">positional arguments</h4>
  3003. <div class="ulist"><ul>
  3004. <li>
  3005. <p>
  3006. <code><em>direction</em></code>: In which direction to scroll (up/down/left/right/top/bottom).
  3007. </p>
  3008. </li>
  3009. </ul></div>
  3010. </div>
  3011. <div class="sect3">
  3012. <h4 id="_count_17">count</h4>
  3013. <div class="paragraph"><p>multiplier</p></div>
  3014. </div>
  3015. </div>
  3016. <div class="sect2">
  3017. <h3 id="scroll-page">scroll-page</h3>
  3018. <div class="paragraph"><p>Syntax: <code>:scroll-page [<strong>--top-navigate</strong> <em>ACTION</em>] [<strong>--bottom-navigate</strong> <em>ACTION</em>] <em>x</em> <em>y</em></code></p></div>
  3019. <div class="paragraph"><p>Scroll the frame page-wise.</p></div>
  3020. <div class="sect3">
  3021. <h4 id="_positional_arguments_47">positional arguments</h4>
  3022. <div class="ulist"><ul>
  3023. <li>
  3024. <p>
  3025. <code><em>x</em></code>: How many pages to scroll to the right.
  3026. </p>
  3027. </li>
  3028. <li>
  3029. <p>
  3030. <code><em>y</em></code>: How many pages to scroll down.
  3031. </p>
  3032. </li>
  3033. </ul></div>
  3034. </div>
  3035. <div class="sect3">
  3036. <h4 id="_optional_arguments_40">optional arguments</h4>
  3037. <div class="ulist"><ul>
  3038. <li>
  3039. <p>
  3040. <code><strong>-t</strong></code>, <code><strong>--top-navigate</strong></code>: :navigate action (prev, decrement) to run when scrolling up at the top of the page.
  3041. </p>
  3042. </li>
  3043. <li>
  3044. <p>
  3045. <code><strong>-b</strong></code>, <code><strong>--bottom-navigate</strong></code>: :navigate action (next, increment) to run when scrolling down at the bottom of the page.
  3046. </p>
  3047. </li>
  3048. </ul></div>
  3049. </div>
  3050. <div class="sect3">
  3051. <h4 id="_count_18">count</h4>
  3052. <div class="paragraph"><p>multiplier</p></div>
  3053. </div>
  3054. </div>
  3055. <div class="sect2">
  3056. <h3 id="scroll-px">scroll-px</h3>
  3057. <div class="paragraph"><p>Syntax: <code>:scroll-px <em>dx</em> <em>dy</em></code></p></div>
  3058. <div class="paragraph"><p>Scroll the current tab by <em>count * dx/dy</em> pixels.</p></div>
  3059. <div class="sect3">
  3060. <h4 id="_positional_arguments_48">positional arguments</h4>
  3061. <div class="ulist"><ul>
  3062. <li>
  3063. <p>
  3064. <code><em>dx</em></code>: How much to scroll in x-direction.
  3065. </p>
  3066. </li>
  3067. <li>
  3068. <p>
  3069. <code><em>dy</em></code>: How much to scroll in y-direction.
  3070. </p>
  3071. </li>
  3072. </ul></div>
  3073. </div>
  3074. <div class="sect3">
  3075. <h4 id="_count_19">count</h4>
  3076. <div class="paragraph"><p>multiplier</p></div>
  3077. </div>
  3078. </div>
  3079. <div class="sect2">
  3080. <h3 id="scroll-to-anchor">scroll-to-anchor</h3>
  3081. <div class="paragraph"><p>Syntax: <code>:scroll-to-anchor <em>name</em></code></p></div>
  3082. <div class="paragraph"><p>Scroll to the given anchor in the document.</p></div>
  3083. <div class="sect3">
  3084. <h4 id="_positional_arguments_49">positional arguments</h4>
  3085. <div class="ulist"><ul>
  3086. <li>
  3087. <p>
  3088. <code><em>name</em></code>: The anchor to scroll to.
  3089. </p>
  3090. </li>
  3091. </ul></div>
  3092. </div>
  3093. </div>
  3094. <div class="sect2">
  3095. <h3 id="scroll-to-perc">scroll-to-perc</h3>
  3096. <div class="paragraph"><p>Syntax: <code>:scroll-to-perc [<strong>--horizontal</strong>] [<em>perc</em>]</code></p></div>
  3097. <div class="paragraph"><p>Scroll to a specific percentage of the page.</p></div>
  3098. <div class="paragraph"><p>The percentage can be given either as argument or as count. If no percentage is given, the page is scrolled to the end.</p></div>
  3099. <div class="sect3">
  3100. <h4 id="_positional_arguments_50">positional arguments</h4>
  3101. <div class="ulist"><ul>
  3102. <li>
  3103. <p>
  3104. <code><em>perc</em></code>: Percentage to scroll.
  3105. </p>
  3106. </li>
  3107. </ul></div>
  3108. </div>
  3109. <div class="sect3">
  3110. <h4 id="_optional_arguments_41">optional arguments</h4>
  3111. <div class="ulist"><ul>
  3112. <li>
  3113. <p>
  3114. <code><strong>-x</strong></code>, <code><strong>--horizontal</strong></code>: Scroll horizontally instead of vertically.
  3115. </p>
  3116. </li>
  3117. </ul></div>
  3118. </div>
  3119. <div class="sect3">
  3120. <h4 id="_count_20">count</h4>
  3121. <div class="paragraph"><p>Percentage to scroll.</p></div>
  3122. </div>
  3123. </div>
  3124. <div class="sect2">
  3125. <h3 id="search">search</h3>
  3126. <div class="paragraph"><p>Syntax: <code>:search [<strong>--reverse</strong>] [<em>text</em>]</code></p></div>
  3127. <div class="paragraph"><p>Search for a text on the current page. With no text, clear results.</p></div>
  3128. <div class="sect3">
  3129. <h4 id="_positional_arguments_51">positional arguments</h4>
  3130. <div class="ulist"><ul>
  3131. <li>
  3132. <p>
  3133. <code><em>text</em></code>: The text to search for.
  3134. </p>
  3135. </li>
  3136. </ul></div>
  3137. </div>
  3138. <div class="sect3">
  3139. <h4 id="_optional_arguments_42">optional arguments</h4>
  3140. <div class="ulist"><ul>
  3141. <li>
  3142. <p>
  3143. <code><strong>-r</strong></code>, <code><strong>--reverse</strong></code>: Reverse search direction.
  3144. </p>
  3145. </li>
  3146. </ul></div>
  3147. </div>
  3148. <div class="sect3">
  3149. <h4 id="_note_14">note</h4>
  3150. <div class="ulist"><ul>
  3151. <li>
  3152. <p>
  3153. This command does not split arguments after the last argument and handles quotes literally.
  3154. </p>
  3155. </li>
  3156. </ul></div>
  3157. </div>
  3158. </div>
  3159. <div class="sect2">
  3160. <h3 id="search-next">search-next</h3>
  3161. <div class="paragraph"><p>Continue the search to the ([count]th) next term.</p></div>
  3162. <div class="sect3">
  3163. <h4 id="_count_21">count</h4>
  3164. <div class="paragraph"><p>How many elements to ignore.</p></div>
  3165. </div>
  3166. </div>
  3167. <div class="sect2">
  3168. <h3 id="search-prev">search-prev</h3>
  3169. <div class="paragraph"><p>Continue the search to the ([count]th) previous term.</p></div>
  3170. <div class="sect3">
  3171. <h4 id="_count_22">count</h4>
  3172. <div class="paragraph"><p>How many elements to ignore.</p></div>
  3173. </div>
  3174. </div>
  3175. <div class="sect2">
  3176. <h3 id="selection-follow">selection-follow</h3>
  3177. <div class="paragraph"><p>Syntax: <code>:selection-follow [<strong>--tab</strong>]</code></p></div>
  3178. <div class="paragraph"><p>Follow the selected text.</p></div>
  3179. <div class="sect3">
  3180. <h4 id="_optional_arguments_43">optional arguments</h4>
  3181. <div class="ulist"><ul>
  3182. <li>
  3183. <p>
  3184. <code><strong>-t</strong></code>, <code><strong>--tab</strong></code>: Load the selected link in a new tab.
  3185. </p>
  3186. </li>
  3187. </ul></div>
  3188. </div>
  3189. </div>
  3190. <div class="sect2">
  3191. <h3 id="session-delete">session-delete</h3>
  3192. <div class="paragraph"><p>Syntax: <code>:session-delete [<strong>--force</strong>] <em>name</em></code></p></div>
  3193. <div class="paragraph"><p>Delete a session.</p></div>
  3194. <div class="sect3">
  3195. <h4 id="_positional_arguments_52">positional arguments</h4>
  3196. <div class="ulist"><ul>
  3197. <li>
  3198. <p>
  3199. <code><em>name</em></code>: The name of the session.
  3200. </p>
  3201. </li>
  3202. </ul></div>
  3203. </div>
  3204. <div class="sect3">
  3205. <h4 id="_optional_arguments_44">optional arguments</h4>
  3206. <div class="ulist"><ul>
  3207. <li>
  3208. <p>
  3209. <code><strong>-f</strong></code>, <code><strong>--force</strong></code>: Force deleting internal sessions (starting with an underline).
  3210. </p>
  3211. </li>
  3212. </ul></div>
  3213. </div>
  3214. </div>
  3215. <div class="sect2">
  3216. <h3 id="session-load">session-load</h3>
  3217. <div class="paragraph"><p>Syntax: <code>:session-load [<strong>--clear</strong>] [<strong>--temp</strong>] [<strong>--force</strong>] [<strong>--delete</strong>] <em>name</em></code></p></div>
  3218. <div class="paragraph"><p>Load a session.</p></div>
  3219. <div class="sect3">
  3220. <h4 id="_positional_arguments_53">positional arguments</h4>
  3221. <div class="ulist"><ul>
  3222. <li>
  3223. <p>
  3224. <code><em>name</em></code>: The name of the session.
  3225. </p>
  3226. </li>
  3227. </ul></div>
  3228. </div>
  3229. <div class="sect3">
  3230. <h4 id="_optional_arguments_45">optional arguments</h4>
  3231. <div class="ulist"><ul>
  3232. <li>
  3233. <p>
  3234. <code><strong>-c</strong></code>, <code><strong>--clear</strong></code>: Close all existing windows.
  3235. </p>
  3236. </li>
  3237. <li>
  3238. <p>
  3239. <code><strong>-t</strong></code>, <code><strong>--temp</strong></code>: Don&#8217;t set the current session for :session-save.
  3240. </p>
  3241. </li>
  3242. <li>
  3243. <p>
  3244. <code><strong>-f</strong></code>, <code><strong>--force</strong></code>: Force loading internal sessions (starting with an underline).
  3245. </p>
  3246. </li>
  3247. <li>
  3248. <p>
  3249. <code><strong>-d</strong></code>, <code><strong>--delete</strong></code>: Delete the saved session once it has loaded.
  3250. </p>
  3251. </li>
  3252. </ul></div>
  3253. </div>
  3254. </div>
  3255. <div class="sect2">
  3256. <h3 id="session-save">session-save</h3>
  3257. <div class="paragraph"><p>Syntax: <code>:session-save [<strong>--current</strong>] [<strong>--quiet</strong>] [<strong>--force</strong>] [<strong>--only-active-window</strong>] [<strong>--with-private</strong>] [<em>name</em>]</code></p></div>
  3258. <div class="paragraph"><p>Save a session.</p></div>
  3259. <div class="sect3">
  3260. <h4 id="_positional_arguments_54">positional arguments</h4>
  3261. <div class="ulist"><ul>
  3262. <li>
  3263. <p>
  3264. <code><em>name</em></code>: The name of the session. If not given, the session configured in session.default_name is saved.
  3265. </p>
  3266. </li>
  3267. </ul></div>
  3268. </div>
  3269. <div class="sect3">
  3270. <h4 id="_optional_arguments_46">optional arguments</h4>
  3271. <div class="ulist"><ul>
  3272. <li>
  3273. <p>
  3274. <code><strong>-c</strong></code>, <code><strong>--current</strong></code>: Save the current session instead of the default.
  3275. </p>
  3276. </li>
  3277. <li>
  3278. <p>
  3279. <code><strong>-q</strong></code>, <code><strong>--quiet</strong></code>: Don&#8217;t show confirmation message.
  3280. </p>
  3281. </li>
  3282. <li>
  3283. <p>
  3284. <code><strong>-f</strong></code>, <code><strong>--force</strong></code>: Force saving internal sessions (starting with an underline).
  3285. </p>
  3286. </li>
  3287. <li>
  3288. <p>
  3289. <code><strong>-o</strong></code>, <code><strong>--only-active-window</strong></code>: Saves only tabs of the currently active window.
  3290. </p>
  3291. </li>
  3292. <li>
  3293. <p>
  3294. <code><strong>-p</strong></code>, <code><strong>--with-private</strong></code>: Include private windows.
  3295. </p>
  3296. </li>
  3297. </ul></div>
  3298. </div>
  3299. </div>
  3300. <div class="sect2">
  3301. <h3 id="set">set</h3>
  3302. <div class="paragraph"><p>Syntax: <code>:set [<strong>--temp</strong>] [<strong>--print</strong>] [<strong>--pattern</strong> <em>pattern</em>] [<em>option</em>] [<em>value</em>]</code></p></div>
  3303. <div class="paragraph"><p>Set an option.</p></div>
  3304. <div class="paragraph"><p>If the option name ends with <em>?</em> or no value is provided, the value of the option is shown instead. Using :set without any arguments opens a page where settings can be changed interactively.</p></div>
  3305. <div class="sect3">
  3306. <h4 id="_positional_arguments_55">positional arguments</h4>
  3307. <div class="ulist"><ul>
  3308. <li>
  3309. <p>
  3310. <code><em>option</em></code>: The name of the option.
  3311. </p>
  3312. </li>
  3313. <li>
  3314. <p>
  3315. <code><em>value</em></code>: The value to set.
  3316. </p>
  3317. </li>
  3318. </ul></div>
  3319. </div>
  3320. <div class="sect3">
  3321. <h4 id="_optional_arguments_47">optional arguments</h4>
  3322. <div class="ulist"><ul>
  3323. <li>
  3324. <p>
  3325. <code><strong>-t</strong></code>, <code><strong>--temp</strong></code>: Set value temporarily until qutebrowser is closed.
  3326. </p>
  3327. </li>
  3328. <li>
  3329. <p>
  3330. <code><strong>-p</strong></code>, <code><strong>--print</strong></code>: Print the value after setting.
  3331. </p>
  3332. </li>
  3333. <li>
  3334. <p>
  3335. <code><strong>-u</strong></code>, <code><strong>--pattern</strong></code>: The URL pattern to use.
  3336. </p>
  3337. </li>
  3338. </ul></div>
  3339. </div>
  3340. </div>
  3341. <div class="sect2">
  3342. <h3 id="set-cmd-text">set-cmd-text</h3>
  3343. <div class="paragraph"><p>Syntax: <code>:set-cmd-text [<strong>--space</strong>] [<strong>--append</strong>] [<strong>--run-on-count</strong>] <em>text</em></code></p></div>
  3344. <div class="paragraph"><p>Preset the statusbar to some text.</p></div>
  3345. <div class="sect3">
  3346. <h4 id="_positional_arguments_56">positional arguments</h4>
  3347. <div class="ulist"><ul>
  3348. <li>
  3349. <p>
  3350. <code><em>text</em></code>: The commandline to set.
  3351. </p>
  3352. </li>
  3353. </ul></div>
  3354. </div>
  3355. <div class="sect3">
  3356. <h4 id="_optional_arguments_48">optional arguments</h4>
  3357. <div class="ulist"><ul>
  3358. <li>
  3359. <p>
  3360. <code><strong>-s</strong></code>, <code><strong>--space</strong></code>: If given, a space is added to the end.
  3361. </p>
  3362. </li>
  3363. <li>
  3364. <p>
  3365. <code><strong>-a</strong></code>, <code><strong>--append</strong></code>: If given, the text is appended to the current text.
  3366. </p>
  3367. </li>
  3368. <li>
  3369. <p>
  3370. <code><strong>-r</strong></code>, <code><strong>--run-on-count</strong></code>: If given with a count, the command is run with the given count rather than setting the command text.
  3371. </p>
  3372. </li>
  3373. </ul></div>
  3374. </div>
  3375. <div class="sect3">
  3376. <h4 id="_count_23">count</h4>
  3377. <div class="paragraph"><p>The count if given.</p></div>
  3378. </div>
  3379. <div class="sect3">
  3380. <h4 id="_note_15">note</h4>
  3381. <div class="ulist"><ul>
  3382. <li>
  3383. <p>
  3384. This command does not split arguments after the last argument and handles quotes literally.
  3385. </p>
  3386. </li>
  3387. </ul></div>
  3388. </div>
  3389. </div>
  3390. <div class="sect2">
  3391. <h3 id="set-mark">set-mark</h3>
  3392. <div class="paragraph"><p>Syntax: <code>:set-mark <em>key</em></code></p></div>
  3393. <div class="paragraph"><p>Set a mark at the current scroll position in the current tab.</p></div>
  3394. <div class="sect3">
  3395. <h4 id="_positional_arguments_57">positional arguments</h4>
  3396. <div class="ulist"><ul>
  3397. <li>
  3398. <p>
  3399. <code><em>key</em></code>: mark identifier; capital indicates a global mark
  3400. </p>
  3401. </li>
  3402. </ul></div>
  3403. </div>
  3404. </div>
  3405. <div class="sect2">
  3406. <h3 id="spawn">spawn</h3>
  3407. <div class="paragraph"><p>Syntax: <code>:spawn [<strong>--userscript</strong>] [<strong>--verbose</strong>] [<strong>--output</strong>] [<strong>--output-messages</strong>] [<strong>--detach</strong>] <em>cmdline</em></code></p></div>
  3408. <div class="paragraph"><p>Spawn an external command.</p></div>
  3409. <div class="paragraph"><p>Note that the command is <strong>not</strong> run in a shell, so things like <code>$VAR</code> or <code>&gt; output</code> won&#8217;t have the desired effect.</p></div>
  3410. <div class="sect3">
  3411. <h4 id="_positional_arguments_58">positional arguments</h4>
  3412. <div class="ulist"><ul>
  3413. <li>
  3414. <p>
  3415. <code><em>cmdline</em></code>: The commandline to execute.
  3416. </p>
  3417. </li>
  3418. </ul></div>
  3419. </div>
  3420. <div class="sect3">
  3421. <h4 id="_optional_arguments_49">optional arguments</h4>
  3422. <div class="ulist"><ul>
  3423. <li>
  3424. <p>
  3425. <code><strong>-u</strong></code>, <code><strong>--userscript</strong></code>: Run the command as a userscript. You can use an absolute path, or store the userscript in one of those
  3426. locations:
  3427. </p>
  3428. <div class="ulist"><ul>
  3429. <li>
  3430. <p>
  3431. <code>~/.local/share/qutebrowser/userscripts</code>
  3432. (or <code>$XDG_DATA_HOME</code>)
  3433. </p>
  3434. </li>
  3435. <li>
  3436. <p>
  3437. <code>/usr/share/qutebrowser/userscripts</code>
  3438. </p>
  3439. </li>
  3440. </ul></div>
  3441. </li>
  3442. <li>
  3443. <p>
  3444. <code><strong>-v</strong></code>, <code><strong>--verbose</strong></code>: Show notifications when the command started/exited.
  3445. </p>
  3446. </li>
  3447. <li>
  3448. <p>
  3449. <code><strong>-o</strong></code>, <code><strong>--output</strong></code>: Show the output in a new tab.
  3450. </p>
  3451. </li>
  3452. <li>
  3453. <p>
  3454. <code><strong>-m</strong></code>, <code><strong>--output-messages</strong></code>: Show the output as messages.
  3455. </p>
  3456. </li>
  3457. <li>
  3458. <p>
  3459. <code><strong>-d</strong></code>, <code><strong>--detach</strong></code>: Detach the command from qutebrowser so that it continues running when qutebrowser quits.
  3460. </p>
  3461. </li>
  3462. </ul></div>
  3463. </div>
  3464. <div class="sect3">
  3465. <h4 id="_count_24">count</h4>
  3466. <div class="paragraph"><p>Given to userscripts as $QUTE_COUNT.</p></div>
  3467. </div>
  3468. <div class="sect3">
  3469. <h4 id="_note_16">note</h4>
  3470. <div class="ulist"><ul>
  3471. <li>
  3472. <p>
  3473. This command does not split arguments after the last argument and handles quotes literally.
  3474. </p>
  3475. </li>
  3476. </ul></div>
  3477. </div>
  3478. </div>
  3479. <div class="sect2">
  3480. <h3 id="stop">stop</h3>
  3481. <div class="paragraph"><p>Stop loading in the current/[count]th tab.</p></div>
  3482. <div class="sect3">
  3483. <h4 id="_count_25">count</h4>
  3484. <div class="paragraph"><p>The tab index to stop.</p></div>
  3485. </div>
  3486. </div>
  3487. <div class="sect2">
  3488. <h3 id="tab-clone">tab-clone</h3>
  3489. <div class="paragraph"><p>Syntax: <code>:tab-clone [<strong>--bg</strong>] [<strong>--window</strong>]</code></p></div>
  3490. <div class="paragraph"><p>Duplicate the current tab.</p></div>
  3491. <div class="sect3">
  3492. <h4 id="_optional_arguments_50">optional arguments</h4>
  3493. <div class="ulist"><ul>
  3494. <li>
  3495. <p>
  3496. <code><strong>-b</strong></code>, <code><strong>--bg</strong></code>: Open in a background tab.
  3497. </p>
  3498. </li>
  3499. <li>
  3500. <p>
  3501. <code><strong>-w</strong></code>, <code><strong>--window</strong></code>: Open in a new window.
  3502. </p>
  3503. </li>
  3504. </ul></div>
  3505. </div>
  3506. </div>
  3507. <div class="sect2">
  3508. <h3 id="tab-close">tab-close</h3>
  3509. <div class="paragraph"><p>Syntax: <code>:tab-close [<strong>--prev</strong>] [<strong>--next</strong>] [<strong>--opposite</strong>] [<strong>--force</strong>]</code></p></div>
  3510. <div class="paragraph"><p>Close the current/[count]th tab.</p></div>
  3511. <div class="sect3">
  3512. <h4 id="_optional_arguments_51">optional arguments</h4>
  3513. <div class="ulist"><ul>
  3514. <li>
  3515. <p>
  3516. <code><strong>-p</strong></code>, <code><strong>--prev</strong></code>: Force selecting the tab before the current tab.
  3517. </p>
  3518. </li>
  3519. <li>
  3520. <p>
  3521. <code><strong>-n</strong></code>, <code><strong>--next</strong></code>: Force selecting the tab after the current tab.
  3522. </p>
  3523. </li>
  3524. <li>
  3525. <p>
  3526. <code><strong>-o</strong></code>, <code><strong>--opposite</strong></code>: Force selecting the tab in the opposite direction of what&#8217;s configured in <em>tabs.select_on_remove</em>.
  3527. </p>
  3528. </li>
  3529. <li>
  3530. <p>
  3531. <code><strong>-f</strong></code>, <code><strong>--force</strong></code>: Avoid confirmation for pinned tabs.
  3532. </p>
  3533. </li>
  3534. </ul></div>
  3535. </div>
  3536. <div class="sect3">
  3537. <h4 id="_count_26">count</h4>
  3538. <div class="paragraph"><p>The tab index to close</p></div>
  3539. </div>
  3540. </div>
  3541. <div class="sect2">
  3542. <h3 id="tab-focus">tab-focus</h3>
  3543. <div class="paragraph"><p>Syntax: <code>:tab-focus [<strong>--no-last</strong>] [<em>index</em>]</code></p></div>
  3544. <div class="paragraph"><p>Select the tab given as argument/[count].</p></div>
  3545. <div class="paragraph"><p>If neither count nor index are given, it behaves like tab-next. If both are given, use count.</p></div>
  3546. <div class="sect3">
  3547. <h4 id="_positional_arguments_59">positional arguments</h4>
  3548. <div class="ulist"><ul>
  3549. <li>
  3550. <p>
  3551. <code><em>index</em></code>: The tab index to focus, starting with 1. The special value <code>last</code> focuses the last focused tab (regardless of count),
  3552. and <code>stack-prev</code>/<code>stack-next</code> traverse a stack of visited
  3553. tabs. Negative indices count from the end, such that -1 is
  3554. the last tab.
  3555. </p>
  3556. </li>
  3557. </ul></div>
  3558. </div>
  3559. <div class="sect3">
  3560. <h4 id="_optional_arguments_52">optional arguments</h4>
  3561. <div class="ulist"><ul>
  3562. <li>
  3563. <p>
  3564. <code><strong>-n</strong></code>, <code><strong>--no-last</strong></code>: Whether to avoid focusing last tab if already focused.
  3565. </p>
  3566. </li>
  3567. </ul></div>
  3568. </div>
  3569. <div class="sect3">
  3570. <h4 id="_count_27">count</h4>
  3571. <div class="paragraph"><p>The tab index to focus, starting with 1.</p></div>
  3572. </div>
  3573. </div>
  3574. <div class="sect2">
  3575. <h3 id="tab-give">tab-give</h3>
  3576. <div class="paragraph"><p>Syntax: <code>:tab-give [<strong>--keep</strong>] [<strong>--private</strong>] [<em>win-id</em>]</code></p></div>
  3577. <div class="paragraph"><p>Give the current tab to a new or existing window if win_id given.</p></div>
  3578. <div class="paragraph"><p>If no win_id is given, the tab will get detached into a new window.</p></div>
  3579. <div class="sect3">
  3580. <h4 id="_positional_arguments_60">positional arguments</h4>
  3581. <div class="ulist"><ul>
  3582. <li>
  3583. <p>
  3584. <code><em>win-id</em></code>: The window ID of the window to give the current tab to.
  3585. </p>
  3586. </li>
  3587. </ul></div>
  3588. </div>
  3589. <div class="sect3">
  3590. <h4 id="_optional_arguments_53">optional arguments</h4>
  3591. <div class="ulist"><ul>
  3592. <li>
  3593. <p>
  3594. <code><strong>-k</strong></code>, <code><strong>--keep</strong></code>: If given, keep the old tab around.
  3595. </p>
  3596. </li>
  3597. <li>
  3598. <p>
  3599. <code><strong>-p</strong></code>, <code><strong>--private</strong></code>: If the tab should be detached into a private instance.
  3600. </p>
  3601. </li>
  3602. </ul></div>
  3603. </div>
  3604. <div class="sect3">
  3605. <h4 id="_count_28">count</h4>
  3606. <div class="paragraph"><p>Overrides win_id (index starts at 1 for win_id=0).</p></div>
  3607. </div>
  3608. </div>
  3609. <div class="sect2">
  3610. <h3 id="tab-move">tab-move</h3>
  3611. <div class="paragraph"><p>Syntax: <code>:tab-move [<em>index</em>]</code></p></div>
  3612. <div class="paragraph"><p>Move the current tab according to the argument and [count].</p></div>
  3613. <div class="paragraph"><p>If neither is given, move it to the first position.</p></div>
  3614. <div class="sect3">
  3615. <h4 id="_positional_arguments_61">positional arguments</h4>
  3616. <div class="ulist"><ul>
  3617. <li>
  3618. <p>
  3619. <code><em>index</em></code>: <code>+</code> or <code>-</code> to move relative to the current tab by count, or a default of 1 space.
  3620. A tab index to move to that index.
  3621. </p>
  3622. </li>
  3623. </ul></div>
  3624. </div>
  3625. <div class="sect3">
  3626. <h4 id="_count_29">count</h4>
  3627. <div class="paragraph"><p>If moving relatively: Offset. If moving absolutely: New position (default: 0). This
  3628. overrides the index argument, if given.</p></div>
  3629. </div>
  3630. </div>
  3631. <div class="sect2">
  3632. <h3 id="tab-mute">tab-mute</h3>
  3633. <div class="paragraph"><p>Mute/Unmute the current/[count]th tab.</p></div>
  3634. <div class="sect3">
  3635. <h4 id="_count_30">count</h4>
  3636. <div class="paragraph"><p>The tab index to mute or unmute</p></div>
  3637. </div>
  3638. </div>
  3639. <div class="sect2">
  3640. <h3 id="tab-next">tab-next</h3>
  3641. <div class="paragraph"><p>Switch to the next tab, or switch [count] tabs forward.</p></div>
  3642. <div class="sect3">
  3643. <h4 id="_count_31">count</h4>
  3644. <div class="paragraph"><p>How many tabs to switch forward.</p></div>
  3645. </div>
  3646. </div>
  3647. <div class="sect2">
  3648. <h3 id="tab-only">tab-only</h3>
  3649. <div class="paragraph"><p>Syntax: <code>:tab-only [<strong>--prev</strong>] [<strong>--next</strong>] [<strong>--pinned</strong> <em>behavior</em>] [<strong>--force</strong>]</code></p></div>
  3650. <div class="paragraph"><p>Close all tabs except for the current one.</p></div>
  3651. <div class="sect3">
  3652. <h4 id="_optional_arguments_54">optional arguments</h4>
  3653. <div class="ulist"><ul>
  3654. <li>
  3655. <p>
  3656. <code><strong>-p</strong></code>, <code><strong>--prev</strong></code>: Keep tabs before the current.
  3657. </p>
  3658. </li>
  3659. <li>
  3660. <p>
  3661. <code><strong>-n</strong></code>, <code><strong>--next</strong></code>: Keep tabs after the current.
  3662. </p>
  3663. </li>
  3664. <li>
  3665. <p>
  3666. <code><strong>-P</strong></code>, <code><strong>--pinned</strong></code>: What to do with pinned tabs. Valid values: prompt, close, keep.
  3667. </p>
  3668. </li>
  3669. <li>
  3670. <p>
  3671. <code><strong>-f</strong></code>, <code><strong>--force</strong></code>: Avoid confirmation for pinned tabs.
  3672. </p>
  3673. </li>
  3674. </ul></div>
  3675. </div>
  3676. </div>
  3677. <div class="sect2">
  3678. <h3 id="tab-pin">tab-pin</h3>
  3679. <div class="paragraph"><p>Pin/Unpin the current/[count]th tab.</p></div>
  3680. <div class="paragraph"><p>Pinning a tab shrinks it to the size of its title text. Attempting to close a pinned tab will cause a confirmation, unless --force is passed.</p></div>
  3681. <div class="sect3">
  3682. <h4 id="_count_32">count</h4>
  3683. <div class="paragraph"><p>The tab index to pin or unpin</p></div>
  3684. </div>
  3685. </div>
  3686. <div class="sect2">
  3687. <h3 id="tab-prev">tab-prev</h3>
  3688. <div class="paragraph"><p>Switch to the previous tab, or switch [count] tabs back.</p></div>
  3689. <div class="sect3">
  3690. <h4 id="_count_33">count</h4>
  3691. <div class="paragraph"><p>How many tabs to switch back.</p></div>
  3692. </div>
  3693. </div>
  3694. <div class="sect2">
  3695. <h3 id="tab-select">tab-select</h3>
  3696. <div class="paragraph"><p>Syntax: <code>:tab-select [<em>index</em>]</code></p></div>
  3697. <div class="paragraph"><p>Select tab by index or url/title best match.</p></div>
  3698. <div class="paragraph"><p>Focuses window if necessary when index is given. If both index and count are given, use count. With neither index nor count given, open the qute://tabs page.</p></div>
  3699. <div class="sect3">
  3700. <h4 id="_positional_arguments_62">positional arguments</h4>
  3701. <div class="ulist"><ul>
  3702. <li>
  3703. <p>
  3704. <code><em>index</em></code>: The [win_id/]index of the tab to focus. Or a substring in which case the closest match will be focused.
  3705. </p>
  3706. </li>
  3707. </ul></div>
  3708. </div>
  3709. <div class="sect3">
  3710. <h4 id="_count_34">count</h4>
  3711. <div class="paragraph"><p>The tab index to focus, starting with 1.</p></div>
  3712. </div>
  3713. <div class="sect3">
  3714. <h4 id="_note_17">note</h4>
  3715. <div class="ulist"><ul>
  3716. <li>
  3717. <p>
  3718. This command does not split arguments after the last argument and handles quotes literally.
  3719. </p>
  3720. </li>
  3721. </ul></div>
  3722. </div>
  3723. </div>
  3724. <div class="sect2">
  3725. <h3 id="tab-take">tab-take</h3>
  3726. <div class="paragraph"><p>Syntax: <code>:tab-take [<strong>--keep</strong>] <em>index</em></code></p></div>
  3727. <div class="paragraph"><p>Take a tab from another window.</p></div>
  3728. <div class="sect3">
  3729. <h4 id="_positional_arguments_63">positional arguments</h4>
  3730. <div class="ulist"><ul>
  3731. <li>
  3732. <p>
  3733. <code><em>index</em></code>: The [win_id/]index of the tab to take. Or a substring in which case the closest match will be taken.
  3734. </p>
  3735. </li>
  3736. </ul></div>
  3737. </div>
  3738. <div class="sect3">
  3739. <h4 id="_optional_arguments_55">optional arguments</h4>
  3740. <div class="ulist"><ul>
  3741. <li>
  3742. <p>
  3743. <code><strong>-k</strong></code>, <code><strong>--keep</strong></code>: If given, keep the old tab around.
  3744. </p>
  3745. </li>
  3746. </ul></div>
  3747. </div>
  3748. <div class="sect3">
  3749. <h4 id="_note_18">note</h4>
  3750. <div class="ulist"><ul>
  3751. <li>
  3752. <p>
  3753. This command does not split arguments after the last argument and handles quotes literally.
  3754. </p>
  3755. </li>
  3756. </ul></div>
  3757. </div>
  3758. </div>
  3759. <div class="sect2">
  3760. <h3 id="unbind">unbind</h3>
  3761. <div class="paragraph"><p>Syntax: <code>:unbind [<strong>--mode</strong> <em>mode</em>] <em>key</em></code></p></div>
  3762. <div class="paragraph"><p>Unbind a keychain.</p></div>
  3763. <div class="sect3">
  3764. <h4 id="_positional_arguments_64">positional arguments</h4>
  3765. <div class="ulist"><ul>
  3766. <li>
  3767. <p>
  3768. <code><em>key</em></code>: The keychain to unbind. See the help for <code>:bind</code> for the correct syntax for keychains.
  3769. </p>
  3770. </li>
  3771. </ul></div>
  3772. </div>
  3773. <div class="sect3">
  3774. <h4 id="_optional_arguments_56">optional arguments</h4>
  3775. <div class="ulist"><ul>
  3776. <li>
  3777. <p>
  3778. <code><strong>-m</strong></code>, <code><strong>--mode</strong></code>: The mode to unbind the key in (default: <code>normal</code>). See <code>:help bindings.commands</code> for the available modes.
  3779. </p>
  3780. </li>
  3781. </ul></div>
  3782. </div>
  3783. </div>
  3784. <div class="sect2">
  3785. <h3 id="undo">undo</h3>
  3786. <div class="paragraph"><p>Syntax: <code>:undo [<strong>--window</strong>] [<em>depth</em>]</code></p></div>
  3787. <div class="paragraph"><p>Re-open the last closed tab(s) or window.</p></div>
  3788. <div class="sect3">
  3789. <h4 id="_positional_arguments_65">positional arguments</h4>
  3790. <div class="ulist"><ul>
  3791. <li>
  3792. <p>
  3793. <code><em>depth</em></code>: Same as <code>count</code> but as argument for completion, <code>count</code> takes precedence.
  3794. </p>
  3795. </li>
  3796. </ul></div>
  3797. </div>
  3798. <div class="sect3">
  3799. <h4 id="_optional_arguments_57">optional arguments</h4>
  3800. <div class="ulist"><ul>
  3801. <li>
  3802. <p>
  3803. <code><strong>-w</strong></code>, <code><strong>--window</strong></code>: Re-open the last closed window (and its tabs).
  3804. </p>
  3805. </li>
  3806. </ul></div>
  3807. </div>
  3808. <div class="sect3">
  3809. <h4 id="_count_35">count</h4>
  3810. <div class="paragraph"><p>How deep in the undo stack to find the tab or tabs to re-open.</p></div>
  3811. </div>
  3812. </div>
  3813. <div class="sect2">
  3814. <h3 id="version">version</h3>
  3815. <div class="paragraph"><p>Syntax: <code>:version [<strong>--paste</strong>]</code></p></div>
  3816. <div class="paragraph"><p>Show version information.</p></div>
  3817. <div class="sect3">
  3818. <h4 id="_optional_arguments_58">optional arguments</h4>
  3819. <div class="ulist"><ul>
  3820. <li>
  3821. <p>
  3822. <code><strong>-p</strong></code>, <code><strong>--paste</strong></code>: Paste to pastebin.
  3823. </p>
  3824. </li>
  3825. </ul></div>
  3826. </div>
  3827. </div>
  3828. <div class="sect2">
  3829. <h3 id="view-source">view-source</h3>
  3830. <div class="paragraph"><p>Syntax: <code>:view-source [<strong>--edit</strong>] [<strong>--pygments</strong>]</code></p></div>
  3831. <div class="paragraph"><p>Show the source of the current page in a new tab.</p></div>
  3832. <div class="sect3">
  3833. <h4 id="_optional_arguments_59">optional arguments</h4>
  3834. <div class="ulist"><ul>
  3835. <li>
  3836. <p>
  3837. <code><strong>-e</strong></code>, <code><strong>--edit</strong></code>: Edit the source in the editor instead of opening a tab.
  3838. </p>
  3839. </li>
  3840. <li>
  3841. <p>
  3842. <code><strong>-p</strong></code>, <code><strong>--pygments</strong></code>: Use pygments to generate the view. This is always the case for QtWebKit. For QtWebEngine it may display
  3843. slightly different source.
  3844. Some JavaScript processing may be applied.
  3845. Needs the optional Pygments dependency for highlighting.
  3846. </p>
  3847. </li>
  3848. </ul></div>
  3849. </div>
  3850. </div>
  3851. <div class="sect2">
  3852. <h3 id="window-only">window-only</h3>
  3853. <div class="paragraph"><p>Close all windows except for the current one.</p></div>
  3854. </div>
  3855. <div class="sect2">
  3856. <h3 id="yank">yank</h3>
  3857. <div class="paragraph"><p>Syntax: <code>:yank [<strong>--sel</strong>] [<strong>--keep</strong>] [<strong>--quiet</strong>] [<em>what</em>] [<em>inline</em>]</code></p></div>
  3858. <div class="paragraph"><p>Yank (copy) something to the clipboard or primary selection.</p></div>
  3859. <div class="sect3">
  3860. <h4 id="_positional_arguments_66">positional arguments</h4>
  3861. <div class="ulist"><ul>
  3862. <li>
  3863. <p>
  3864. <code><em>what</em></code>: What to yank.
  3865. </p>
  3866. <div class="ulist"><ul>
  3867. <li>
  3868. <p>
  3869. <code>url</code>: The current URL.
  3870. </p>
  3871. </li>
  3872. <li>
  3873. <p>
  3874. <code>pretty-url</code>: The URL in pretty decoded form.
  3875. </p>
  3876. </li>
  3877. <li>
  3878. <p>
  3879. <code>title</code>: The current page&#8217;s title.
  3880. </p>
  3881. </li>
  3882. <li>
  3883. <p>
  3884. <code>domain</code>: The current scheme, domain, and port number.
  3885. </p>
  3886. </li>
  3887. <li>
  3888. <p>
  3889. <code>selection</code>: The selection under the cursor.
  3890. </p>
  3891. </li>
  3892. <li>
  3893. <p>
  3894. <code>inline</code>: Yank the text contained in the <em>inline</em> argument.
  3895. </p>
  3896. </li>
  3897. </ul></div>
  3898. </li>
  3899. <li>
  3900. <p>
  3901. <code><em>inline</em></code>: A block of text, to be yanked if <em>what</em> is inline and ignored otherwise.
  3902. </p>
  3903. </li>
  3904. </ul></div>
  3905. </div>
  3906. <div class="sect3">
  3907. <h4 id="_optional_arguments_60">optional arguments</h4>
  3908. <div class="ulist"><ul>
  3909. <li>
  3910. <p>
  3911. <code><strong>-s</strong></code>, <code><strong>--sel</strong></code>: Use the primary selection instead of the clipboard.
  3912. </p>
  3913. </li>
  3914. <li>
  3915. <p>
  3916. <code><strong>-k</strong></code>, <code><strong>--keep</strong></code>: Stay in visual mode after yanking the selection.
  3917. </p>
  3918. </li>
  3919. <li>
  3920. <p>
  3921. <code><strong>-q</strong></code>, <code><strong>--quiet</strong></code>: Don&#8217;t show an information message.
  3922. </p>
  3923. </li>
  3924. </ul></div>
  3925. </div>
  3926. </div>
  3927. <div class="sect2">
  3928. <h3 id="zoom">zoom</h3>
  3929. <div class="paragraph"><p>Syntax: <code>:zoom [<strong>--quiet</strong>] [<em>level</em>]</code></p></div>
  3930. <div class="paragraph"><p>Set the zoom level for the current tab.</p></div>
  3931. <div class="paragraph"><p>The zoom can be given as argument or as [count]. If neither is given, the zoom is set to the default zoom. If both are given, use [count].</p></div>
  3932. <div class="sect3">
  3933. <h4 id="_positional_arguments_67">positional arguments</h4>
  3934. <div class="ulist"><ul>
  3935. <li>
  3936. <p>
  3937. <code><em>level</em></code>: The zoom percentage to set.
  3938. </p>
  3939. </li>
  3940. </ul></div>
  3941. </div>
  3942. <div class="sect3">
  3943. <h4 id="_optional_arguments_61">optional arguments</h4>
  3944. <div class="ulist"><ul>
  3945. <li>
  3946. <p>
  3947. <code><strong>-q</strong></code>, <code><strong>--quiet</strong></code>: Don&#8217;t show a zoom level message.
  3948. </p>
  3949. </li>
  3950. </ul></div>
  3951. </div>
  3952. <div class="sect3">
  3953. <h4 id="_count_36">count</h4>
  3954. <div class="paragraph"><p>The zoom percentage to set.</p></div>
  3955. </div>
  3956. </div>
  3957. <div class="sect2">
  3958. <h3 id="zoom-in">zoom-in</h3>
  3959. <div class="paragraph"><p>Syntax: <code>:zoom-in [<strong>--quiet</strong>]</code></p></div>
  3960. <div class="paragraph"><p>Increase the zoom level for the current tab.</p></div>
  3961. <div class="sect3">
  3962. <h4 id="_optional_arguments_62">optional arguments</h4>
  3963. <div class="ulist"><ul>
  3964. <li>
  3965. <p>
  3966. <code><strong>-q</strong></code>, <code><strong>--quiet</strong></code>: Don&#8217;t show a zoom level message.
  3967. </p>
  3968. </li>
  3969. </ul></div>
  3970. </div>
  3971. <div class="sect3">
  3972. <h4 id="_count_37">count</h4>
  3973. <div class="paragraph"><p>How many steps to zoom in.</p></div>
  3974. </div>
  3975. </div>
  3976. <div class="sect2">
  3977. <h3 id="zoom-out">zoom-out</h3>
  3978. <div class="paragraph"><p>Syntax: <code>:zoom-out [<strong>--quiet</strong>]</code></p></div>
  3979. <div class="paragraph"><p>Decrease the zoom level for the current tab.</p></div>
  3980. <div class="sect3">
  3981. <h4 id="_optional_arguments_63">optional arguments</h4>
  3982. <div class="ulist"><ul>
  3983. <li>
  3984. <p>
  3985. <code><strong>-q</strong></code>, <code><strong>--quiet</strong></code>: Don&#8217;t show a zoom level message.
  3986. </p>
  3987. </li>
  3988. </ul></div>
  3989. </div>
  3990. <div class="sect3">
  3991. <h4 id="_count_38">count</h4>
  3992. <div class="paragraph"><p>How many steps to zoom out.</p></div>
  3993. </div>
  3994. </div>
  3995. </div>
  3996. </div>
  3997. <div class="sect1">
  3998. <h2 id="_commands_not_usable_in_normal_mode">Commands not usable in normal mode</h2>
  3999. <div class="sectionbody">
  4000. <div class="tableblock">
  4001. <table rules="all"
  4002. width="75%"
  4003. frame="border"
  4004. cellspacing="0" cellpadding="4">
  4005. <caption class="title">Table 2. Quick reference</caption>
  4006. <col width="25%" />
  4007. <col width="75%" />
  4008. <thead>
  4009. <tr>
  4010. <th align="left" valign="top">Command</th>
  4011. <th align="left" valign="top">Description</th>
  4012. </tr>
  4013. </thead>
  4014. <tbody>
  4015. <tr>
  4016. <td align="left" valign="top"><p class="table"><a href="#command-accept">command-accept</a></p></td>
  4017. <td align="left" valign="top"><p class="table">Execute the command currently in the commandline.</p></td>
  4018. </tr>
  4019. <tr>
  4020. <td align="left" valign="top"><p class="table"><a href="#command-history-next">command-history-next</a></p></td>
  4021. <td align="left" valign="top"><p class="table">Go forward in the commandline history.</p></td>
  4022. </tr>
  4023. <tr>
  4024. <td align="left" valign="top"><p class="table"><a href="#command-history-prev">command-history-prev</a></p></td>
  4025. <td align="left" valign="top"><p class="table">Go back in the commandline history.</p></td>
  4026. </tr>
  4027. <tr>
  4028. <td align="left" valign="top"><p class="table"><a href="#completion-item-del">completion-item-del</a></p></td>
  4029. <td align="left" valign="top"><p class="table">Delete the current completion item.</p></td>
  4030. </tr>
  4031. <tr>
  4032. <td align="left" valign="top"><p class="table"><a href="#completion-item-focus">completion-item-focus</a></p></td>
  4033. <td align="left" valign="top"><p class="table">Shift the focus of the completion menu to another item.</p></td>
  4034. </tr>
  4035. <tr>
  4036. <td align="left" valign="top"><p class="table"><a href="#completion-item-yank">completion-item-yank</a></p></td>
  4037. <td align="left" valign="top"><p class="table">Yank the current completion item into the clipboard.</p></td>
  4038. </tr>
  4039. <tr>
  4040. <td align="left" valign="top"><p class="table"><a href="#hint-follow">hint-follow</a></p></td>
  4041. <td align="left" valign="top"><p class="table">Follow a hint.</p></td>
  4042. </tr>
  4043. <tr>
  4044. <td align="left" valign="top"><p class="table"><a href="#mode-leave">mode-leave</a></p></td>
  4045. <td align="left" valign="top"><p class="table">Leave the mode we&#8217;re currently in.</p></td>
  4046. </tr>
  4047. <tr>
  4048. <td align="left" valign="top"><p class="table"><a href="#move-to-end-of-document">move-to-end-of-document</a></p></td>
  4049. <td align="left" valign="top"><p class="table">Move the cursor or selection to the end of the document.</p></td>
  4050. </tr>
  4051. <tr>
  4052. <td align="left" valign="top"><p class="table"><a href="#move-to-end-of-line">move-to-end-of-line</a></p></td>
  4053. <td align="left" valign="top"><p class="table">Move the cursor or selection to the end of line.</p></td>
  4054. </tr>
  4055. <tr>
  4056. <td align="left" valign="top"><p class="table"><a href="#move-to-end-of-next-block">move-to-end-of-next-block</a></p></td>
  4057. <td align="left" valign="top"><p class="table">Move the cursor or selection to the end of next block.</p></td>
  4058. </tr>
  4059. <tr>
  4060. <td align="left" valign="top"><p class="table"><a href="#move-to-end-of-prev-block">move-to-end-of-prev-block</a></p></td>
  4061. <td align="left" valign="top"><p class="table">Move the cursor or selection to the end of previous block.</p></td>
  4062. </tr>
  4063. <tr>
  4064. <td align="left" valign="top"><p class="table"><a href="#move-to-end-of-word">move-to-end-of-word</a></p></td>
  4065. <td align="left" valign="top"><p class="table">Move the cursor or selection to the end of the word.</p></td>
  4066. </tr>
  4067. <tr>
  4068. <td align="left" valign="top"><p class="table"><a href="#move-to-next-char">move-to-next-char</a></p></td>
  4069. <td align="left" valign="top"><p class="table">Move the cursor or selection to the next char.</p></td>
  4070. </tr>
  4071. <tr>
  4072. <td align="left" valign="top"><p class="table"><a href="#move-to-next-line">move-to-next-line</a></p></td>
  4073. <td align="left" valign="top"><p class="table">Move the cursor or selection to the next line.</p></td>
  4074. </tr>
  4075. <tr>
  4076. <td align="left" valign="top"><p class="table"><a href="#move-to-next-word">move-to-next-word</a></p></td>
  4077. <td align="left" valign="top"><p class="table">Move the cursor or selection to the next word.</p></td>
  4078. </tr>
  4079. <tr>
  4080. <td align="left" valign="top"><p class="table"><a href="#move-to-prev-char">move-to-prev-char</a></p></td>
  4081. <td align="left" valign="top"><p class="table">Move the cursor or selection to the previous char.</p></td>
  4082. </tr>
  4083. <tr>
  4084. <td align="left" valign="top"><p class="table"><a href="#move-to-prev-line">move-to-prev-line</a></p></td>
  4085. <td align="left" valign="top"><p class="table">Move the cursor or selection to the prev line.</p></td>
  4086. </tr>
  4087. <tr>
  4088. <td align="left" valign="top"><p class="table"><a href="#move-to-prev-word">move-to-prev-word</a></p></td>
  4089. <td align="left" valign="top"><p class="table">Move the cursor or selection to the previous word.</p></td>
  4090. </tr>
  4091. <tr>
  4092. <td align="left" valign="top"><p class="table"><a href="#move-to-start-of-document">move-to-start-of-document</a></p></td>
  4093. <td align="left" valign="top"><p class="table">Move the cursor or selection to the start of the document.</p></td>
  4094. </tr>
  4095. <tr>
  4096. <td align="left" valign="top"><p class="table"><a href="#move-to-start-of-line">move-to-start-of-line</a></p></td>
  4097. <td align="left" valign="top"><p class="table">Move the cursor or selection to the start of the line.</p></td>
  4098. </tr>
  4099. <tr>
  4100. <td align="left" valign="top"><p class="table"><a href="#move-to-start-of-next-block">move-to-start-of-next-block</a></p></td>
  4101. <td align="left" valign="top"><p class="table">Move the cursor or selection to the start of next block.</p></td>
  4102. </tr>
  4103. <tr>
  4104. <td align="left" valign="top"><p class="table"><a href="#move-to-start-of-prev-block">move-to-start-of-prev-block</a></p></td>
  4105. <td align="left" valign="top"><p class="table">Move the cursor or selection to the start of previous block.</p></td>
  4106. </tr>
  4107. <tr>
  4108. <td align="left" valign="top"><p class="table"><a href="#prompt-accept">prompt-accept</a></p></td>
  4109. <td align="left" valign="top"><p class="table">Accept the current prompt.</p></td>
  4110. </tr>
  4111. <tr>
  4112. <td align="left" valign="top"><p class="table"><a href="#prompt-item-focus">prompt-item-focus</a></p></td>
  4113. <td align="left" valign="top"><p class="table">Shift the focus of the prompt file completion menu to another item.</p></td>
  4114. </tr>
  4115. <tr>
  4116. <td align="left" valign="top"><p class="table"><a href="#prompt-open-download">prompt-open-download</a></p></td>
  4117. <td align="left" valign="top"><p class="table">Immediately open a download.</p></td>
  4118. </tr>
  4119. <tr>
  4120. <td align="left" valign="top"><p class="table"><a href="#prompt-yank">prompt-yank</a></p></td>
  4121. <td align="left" valign="top"><p class="table">Yank URL to clipboard or primary selection.</p></td>
  4122. </tr>
  4123. <tr>
  4124. <td align="left" valign="top"><p class="table"><a href="#rl-backward-char">rl-backward-char</a></p></td>
  4125. <td align="left" valign="top"><p class="table">Move back a character.</p></td>
  4126. </tr>
  4127. <tr>
  4128. <td align="left" valign="top"><p class="table"><a href="#rl-backward-delete-char">rl-backward-delete-char</a></p></td>
  4129. <td align="left" valign="top"><p class="table">Delete the character before the cursor.</p></td>
  4130. </tr>
  4131. <tr>
  4132. <td align="left" valign="top"><p class="table"><a href="#rl-backward-kill-word">rl-backward-kill-word</a></p></td>
  4133. <td align="left" valign="top"><p class="table">Remove chars from the cursor to the beginning of the word.</p></td>
  4134. </tr>
  4135. <tr>
  4136. <td align="left" valign="top"><p class="table"><a href="#rl-backward-word">rl-backward-word</a></p></td>
  4137. <td align="left" valign="top"><p class="table">Move back to the start of the current or previous word.</p></td>
  4138. </tr>
  4139. <tr>
  4140. <td align="left" valign="top"><p class="table"><a href="#rl-beginning-of-line">rl-beginning-of-line</a></p></td>
  4141. <td align="left" valign="top"><p class="table">Move to the start of the line.</p></td>
  4142. </tr>
  4143. <tr>
  4144. <td align="left" valign="top"><p class="table"><a href="#rl-delete-char">rl-delete-char</a></p></td>
  4145. <td align="left" valign="top"><p class="table">Delete the character after the cursor.</p></td>
  4146. </tr>
  4147. <tr>
  4148. <td align="left" valign="top"><p class="table"><a href="#rl-end-of-line">rl-end-of-line</a></p></td>
  4149. <td align="left" valign="top"><p class="table">Move to the end of the line.</p></td>
  4150. </tr>
  4151. <tr>
  4152. <td align="left" valign="top"><p class="table"><a href="#rl-forward-char">rl-forward-char</a></p></td>
  4153. <td align="left" valign="top"><p class="table">Move forward a character.</p></td>
  4154. </tr>
  4155. <tr>
  4156. <td align="left" valign="top"><p class="table"><a href="#rl-forward-word">rl-forward-word</a></p></td>
  4157. <td align="left" valign="top"><p class="table">Move forward to the end of the next word.</p></td>
  4158. </tr>
  4159. <tr>
  4160. <td align="left" valign="top"><p class="table"><a href="#rl-kill-line">rl-kill-line</a></p></td>
  4161. <td align="left" valign="top"><p class="table">Remove chars from the cursor to the end of the line.</p></td>
  4162. </tr>
  4163. <tr>
  4164. <td align="left" valign="top"><p class="table"><a href="#rl-kill-word">rl-kill-word</a></p></td>
  4165. <td align="left" valign="top"><p class="table">Remove chars from the cursor to the end of the current word.</p></td>
  4166. </tr>
  4167. <tr>
  4168. <td align="left" valign="top"><p class="table"><a href="#rl-unix-filename-rubout">rl-unix-filename-rubout</a></p></td>
  4169. <td align="left" valign="top"><p class="table">Remove chars from the cursor to the previous path separator.</p></td>
  4170. </tr>
  4171. <tr>
  4172. <td align="left" valign="top"><p class="table"><a href="#rl-unix-line-discard">rl-unix-line-discard</a></p></td>
  4173. <td align="left" valign="top"><p class="table">Remove chars backward from the cursor to the beginning of the line.</p></td>
  4174. </tr>
  4175. <tr>
  4176. <td align="left" valign="top"><p class="table"><a href="#rl-unix-word-rubout">rl-unix-word-rubout</a></p></td>
  4177. <td align="left" valign="top"><p class="table">Remove chars from the cursor to the beginning of the word.</p></td>
  4178. </tr>
  4179. <tr>
  4180. <td align="left" valign="top"><p class="table"><a href="#rl-yank">rl-yank</a></p></td>
  4181. <td align="left" valign="top"><p class="table">Paste the most recently deleted text.</p></td>
  4182. </tr>
  4183. <tr>
  4184. <td align="left" valign="top"><p class="table"><a href="#selection-drop">selection-drop</a></p></td>
  4185. <td align="left" valign="top"><p class="table">Drop selection and keep selection mode enabled.</p></td>
  4186. </tr>
  4187. <tr>
  4188. <td align="left" valign="top"><p class="table"><a href="#selection-reverse">selection-reverse</a></p></td>
  4189. <td align="left" valign="top"><p class="table">Swap the stationary and moving end of the current selection.</p></td>
  4190. </tr>
  4191. <tr>
  4192. <td align="left" valign="top"><p class="table"><a href="#selection-toggle">selection-toggle</a></p></td>
  4193. <td align="left" valign="top"><p class="table">Toggle caret selection mode.</p></td>
  4194. </tr>
  4195. </tbody>
  4196. </table>
  4197. </div>
  4198. <div class="sect2">
  4199. <h3 id="command-accept">command-accept</h3>
  4200. <div class="paragraph"><p>Syntax: <code>:command-accept [<strong>--rapid</strong>]</code></p></div>
  4201. <div class="paragraph"><p>Execute the command currently in the commandline.</p></div>
  4202. <div class="sect3">
  4203. <h4 id="_optional_arguments_64">optional arguments</h4>
  4204. <div class="ulist"><ul>
  4205. <li>
  4206. <p>
  4207. <code><strong>-r</strong></code>, <code><strong>--rapid</strong></code>: Run the command without closing or clearing the command bar.
  4208. </p>
  4209. </li>
  4210. </ul></div>
  4211. </div>
  4212. </div>
  4213. <div class="sect2">
  4214. <h3 id="command-history-next">command-history-next</h3>
  4215. <div class="paragraph"><p>Go forward in the commandline history.</p></div>
  4216. </div>
  4217. <div class="sect2">
  4218. <h3 id="command-history-prev">command-history-prev</h3>
  4219. <div class="paragraph"><p>Go back in the commandline history.</p></div>
  4220. </div>
  4221. <div class="sect2">
  4222. <h3 id="completion-item-del">completion-item-del</h3>
  4223. <div class="paragraph"><p>Delete the current completion item.</p></div>
  4224. </div>
  4225. <div class="sect2">
  4226. <h3 id="completion-item-focus">completion-item-focus</h3>
  4227. <div class="paragraph"><p>Syntax: <code>:completion-item-focus [<strong>--history</strong>] <em>which</em></code></p></div>
  4228. <div class="paragraph"><p>Shift the focus of the completion menu to another item.</p></div>
  4229. <div class="sect3">
  4230. <h4 id="_positional_arguments_68">positional arguments</h4>
  4231. <div class="ulist"><ul>
  4232. <li>
  4233. <p>
  4234. <code><em>which</em></code>: <em>next</em>, <em>prev</em>, <em>next-category</em>, <em>prev-category</em>,
  4235. <em>next-page</em>, or <em>prev-page</em>.
  4236. </p>
  4237. </li>
  4238. </ul></div>
  4239. </div>
  4240. <div class="sect3">
  4241. <h4 id="_optional_arguments_65">optional arguments</h4>
  4242. <div class="ulist"><ul>
  4243. <li>
  4244. <p>
  4245. <code><strong>-H</strong></code>, <code><strong>--history</strong></code>: Navigate through command history if no text was typed.
  4246. </p>
  4247. </li>
  4248. </ul></div>
  4249. </div>
  4250. </div>
  4251. <div class="sect2">
  4252. <h3 id="completion-item-yank">completion-item-yank</h3>
  4253. <div class="paragraph"><p>Syntax: <code>:completion-item-yank [<strong>--sel</strong>]</code></p></div>
  4254. <div class="paragraph"><p>Yank the current completion item into the clipboard.</p></div>
  4255. <div class="sect3">
  4256. <h4 id="_optional_arguments_66">optional arguments</h4>
  4257. <div class="ulist"><ul>
  4258. <li>
  4259. <p>
  4260. <code><strong>-s</strong></code>, <code><strong>--sel</strong></code>: Use the primary selection instead of the clipboard.
  4261. </p>
  4262. </li>
  4263. </ul></div>
  4264. </div>
  4265. </div>
  4266. <div class="sect2">
  4267. <h3 id="hint-follow">hint-follow</h3>
  4268. <div class="paragraph"><p>Syntax: <code>:hint-follow [<strong>--select</strong>] [<em>keystring</em>]</code></p></div>
  4269. <div class="paragraph"><p>Follow a hint.</p></div>
  4270. <div class="sect3">
  4271. <h4 id="_positional_arguments_69">positional arguments</h4>
  4272. <div class="ulist"><ul>
  4273. <li>
  4274. <p>
  4275. <code><em>keystring</em></code>: The hint to follow.
  4276. </p>
  4277. </li>
  4278. </ul></div>
  4279. </div>
  4280. <div class="sect3">
  4281. <h4 id="_optional_arguments_67">optional arguments</h4>
  4282. <div class="ulist"><ul>
  4283. <li>
  4284. <p>
  4285. <code><strong>-s</strong></code>, <code><strong>--select</strong></code>: Only select the given hint, don&#8217;t necessarily follow it.
  4286. </p>
  4287. </li>
  4288. </ul></div>
  4289. </div>
  4290. </div>
  4291. <div class="sect2">
  4292. <h3 id="mode-leave">mode-leave</h3>
  4293. <div class="paragraph"><p>Leave the mode we&#8217;re currently in.</p></div>
  4294. </div>
  4295. <div class="sect2">
  4296. <h3 id="move-to-end-of-document">move-to-end-of-document</h3>
  4297. <div class="paragraph"><p>Move the cursor or selection to the end of the document.</p></div>
  4298. </div>
  4299. <div class="sect2">
  4300. <h3 id="move-to-end-of-line">move-to-end-of-line</h3>
  4301. <div class="paragraph"><p>Move the cursor or selection to the end of line.</p></div>
  4302. </div>
  4303. <div class="sect2">
  4304. <h3 id="move-to-end-of-next-block">move-to-end-of-next-block</h3>
  4305. <div class="paragraph"><p>Move the cursor or selection to the end of next block.</p></div>
  4306. <div class="sect3">
  4307. <h4 id="_count_39">count</h4>
  4308. <div class="paragraph"><p>How many blocks to move.</p></div>
  4309. </div>
  4310. </div>
  4311. <div class="sect2">
  4312. <h3 id="move-to-end-of-prev-block">move-to-end-of-prev-block</h3>
  4313. <div class="paragraph"><p>Move the cursor or selection to the end of previous block.</p></div>
  4314. <div class="sect3">
  4315. <h4 id="_count_40">count</h4>
  4316. <div class="paragraph"><p>How many blocks to move.</p></div>
  4317. </div>
  4318. </div>
  4319. <div class="sect2">
  4320. <h3 id="move-to-end-of-word">move-to-end-of-word</h3>
  4321. <div class="paragraph"><p>Move the cursor or selection to the end of the word.</p></div>
  4322. <div class="sect3">
  4323. <h4 id="_count_41">count</h4>
  4324. <div class="paragraph"><p>How many words to move.</p></div>
  4325. </div>
  4326. </div>
  4327. <div class="sect2">
  4328. <h3 id="move-to-next-char">move-to-next-char</h3>
  4329. <div class="paragraph"><p>Move the cursor or selection to the next char.</p></div>
  4330. <div class="sect3">
  4331. <h4 id="_count_42">count</h4>
  4332. <div class="paragraph"><p>How many lines to move.</p></div>
  4333. </div>
  4334. </div>
  4335. <div class="sect2">
  4336. <h3 id="move-to-next-line">move-to-next-line</h3>
  4337. <div class="paragraph"><p>Move the cursor or selection to the next line.</p></div>
  4338. <div class="sect3">
  4339. <h4 id="_count_43">count</h4>
  4340. <div class="paragraph"><p>How many lines to move.</p></div>
  4341. </div>
  4342. </div>
  4343. <div class="sect2">
  4344. <h3 id="move-to-next-word">move-to-next-word</h3>
  4345. <div class="paragraph"><p>Move the cursor or selection to the next word.</p></div>
  4346. <div class="sect3">
  4347. <h4 id="_count_44">count</h4>
  4348. <div class="paragraph"><p>How many words to move.</p></div>
  4349. </div>
  4350. </div>
  4351. <div class="sect2">
  4352. <h3 id="move-to-prev-char">move-to-prev-char</h3>
  4353. <div class="paragraph"><p>Move the cursor or selection to the previous char.</p></div>
  4354. <div class="sect3">
  4355. <h4 id="_count_45">count</h4>
  4356. <div class="paragraph"><p>How many chars to move.</p></div>
  4357. </div>
  4358. </div>
  4359. <div class="sect2">
  4360. <h3 id="move-to-prev-line">move-to-prev-line</h3>
  4361. <div class="paragraph"><p>Move the cursor or selection to the prev line.</p></div>
  4362. <div class="sect3">
  4363. <h4 id="_count_46">count</h4>
  4364. <div class="paragraph"><p>How many lines to move.</p></div>
  4365. </div>
  4366. </div>
  4367. <div class="sect2">
  4368. <h3 id="move-to-prev-word">move-to-prev-word</h3>
  4369. <div class="paragraph"><p>Move the cursor or selection to the previous word.</p></div>
  4370. <div class="sect3">
  4371. <h4 id="_count_47">count</h4>
  4372. <div class="paragraph"><p>How many words to move.</p></div>
  4373. </div>
  4374. </div>
  4375. <div class="sect2">
  4376. <h3 id="move-to-start-of-document">move-to-start-of-document</h3>
  4377. <div class="paragraph"><p>Move the cursor or selection to the start of the document.</p></div>
  4378. </div>
  4379. <div class="sect2">
  4380. <h3 id="move-to-start-of-line">move-to-start-of-line</h3>
  4381. <div class="paragraph"><p>Move the cursor or selection to the start of the line.</p></div>
  4382. </div>
  4383. <div class="sect2">
  4384. <h3 id="move-to-start-of-next-block">move-to-start-of-next-block</h3>
  4385. <div class="paragraph"><p>Move the cursor or selection to the start of next block.</p></div>
  4386. <div class="sect3">
  4387. <h4 id="_count_48">count</h4>
  4388. <div class="paragraph"><p>How many blocks to move.</p></div>
  4389. </div>
  4390. </div>
  4391. <div class="sect2">
  4392. <h3 id="move-to-start-of-prev-block">move-to-start-of-prev-block</h3>
  4393. <div class="paragraph"><p>Move the cursor or selection to the start of previous block.</p></div>
  4394. <div class="sect3">
  4395. <h4 id="_count_49">count</h4>
  4396. <div class="paragraph"><p>How many blocks to move.</p></div>
  4397. </div>
  4398. </div>
  4399. <div class="sect2">
  4400. <h3 id="prompt-accept">prompt-accept</h3>
  4401. <div class="paragraph"><p>Syntax: <code>:prompt-accept [<strong>--save</strong>] [<em>value</em>]</code></p></div>
  4402. <div class="paragraph"><p>Accept the current prompt.</p></div>
  4403. <div class="sect3">
  4404. <h4 id="_positional_arguments_70">positional arguments</h4>
  4405. <div class="ulist"><ul>
  4406. <li>
  4407. <p>
  4408. <code><em>value</em></code>: If given, uses this value instead of the entered one. For boolean prompts, "yes"/"no" are accepted as value.
  4409. </p>
  4410. </li>
  4411. </ul></div>
  4412. </div>
  4413. <div class="sect3">
  4414. <h4 id="_optional_arguments_68">optional arguments</h4>
  4415. <div class="ulist"><ul>
  4416. <li>
  4417. <p>
  4418. <code><strong>-s</strong></code>, <code><strong>--save</strong></code>: Save the value to the config.
  4419. </p>
  4420. </li>
  4421. </ul></div>
  4422. </div>
  4423. </div>
  4424. <div class="sect2">
  4425. <h3 id="prompt-item-focus">prompt-item-focus</h3>
  4426. <div class="paragraph"><p>Syntax: <code>:prompt-item-focus <em>which</em></code></p></div>
  4427. <div class="paragraph"><p>Shift the focus of the prompt file completion menu to another item.</p></div>
  4428. <div class="sect3">
  4429. <h4 id="_positional_arguments_71">positional arguments</h4>
  4430. <div class="ulist"><ul>
  4431. <li>
  4432. <p>
  4433. <code><em>which</em></code>: <em>next</em>, <em>prev</em>
  4434. </p>
  4435. </li>
  4436. </ul></div>
  4437. </div>
  4438. </div>
  4439. <div class="sect2">
  4440. <h3 id="prompt-open-download">prompt-open-download</h3>
  4441. <div class="paragraph"><p>Syntax: <code>:prompt-open-download [<strong>--pdfjs</strong>] [<em>cmdline</em>]</code></p></div>
  4442. <div class="paragraph"><p>Immediately open a download.</p></div>
  4443. <div class="paragraph"><p>If no specific command is given, this will use the system&#8217;s default application to open the file.</p></div>
  4444. <div class="sect3">
  4445. <h4 id="_positional_arguments_72">positional arguments</h4>
  4446. <div class="ulist"><ul>
  4447. <li>
  4448. <p>
  4449. <code><em>cmdline</em></code>: The command which should be used to open the file. A <code>{}</code> is expanded to the temporary file name. If no <code>{}</code> is
  4450. present, the filename is automatically appended to the
  4451. cmdline.
  4452. </p>
  4453. </li>
  4454. </ul></div>
  4455. </div>
  4456. <div class="sect3">
  4457. <h4 id="_optional_arguments_69">optional arguments</h4>
  4458. <div class="ulist"><ul>
  4459. <li>
  4460. <p>
  4461. <code><strong>-p</strong></code>, <code><strong>--pdfjs</strong></code>: Open the download via PDF.js.
  4462. </p>
  4463. </li>
  4464. </ul></div>
  4465. </div>
  4466. <div class="sect3">
  4467. <h4 id="_note_19">note</h4>
  4468. <div class="ulist"><ul>
  4469. <li>
  4470. <p>
  4471. This command does not split arguments after the last argument and handles quotes literally.
  4472. </p>
  4473. </li>
  4474. </ul></div>
  4475. </div>
  4476. </div>
  4477. <div class="sect2">
  4478. <h3 id="prompt-yank">prompt-yank</h3>
  4479. <div class="paragraph"><p>Syntax: <code>:prompt-yank [<strong>--sel</strong>]</code></p></div>
  4480. <div class="paragraph"><p>Yank URL to clipboard or primary selection.</p></div>
  4481. <div class="sect3">
  4482. <h4 id="_optional_arguments_70">optional arguments</h4>
  4483. <div class="ulist"><ul>
  4484. <li>
  4485. <p>
  4486. <code><strong>-s</strong></code>, <code><strong>--sel</strong></code>: Use the primary selection instead of the clipboard.
  4487. </p>
  4488. </li>
  4489. </ul></div>
  4490. </div>
  4491. </div>
  4492. <div class="sect2">
  4493. <h3 id="rl-backward-char">rl-backward-char</h3>
  4494. <div class="paragraph"><p>Move back a character.</p></div>
  4495. <div class="paragraph"><p>This acts like readline&#8217;s backward-char.</p></div>
  4496. </div>
  4497. <div class="sect2">
  4498. <h3 id="rl-backward-delete-char">rl-backward-delete-char</h3>
  4499. <div class="paragraph"><p>Delete the character before the cursor.</p></div>
  4500. <div class="paragraph"><p>This acts like readline&#8217;s backward-delete-char.</p></div>
  4501. </div>
  4502. <div class="sect2">
  4503. <h3 id="rl-backward-kill-word">rl-backward-kill-word</h3>
  4504. <div class="paragraph"><p>Remove chars from the cursor to the beginning of the word.</p></div>
  4505. <div class="paragraph"><p>This acts like readline&#8217;s backward-kill-word. Any non-alphanumeric character is considered a word delimiter.</p></div>
  4506. </div>
  4507. <div class="sect2">
  4508. <h3 id="rl-backward-word">rl-backward-word</h3>
  4509. <div class="paragraph"><p>Move back to the start of the current or previous word.</p></div>
  4510. <div class="paragraph"><p>This acts like readline&#8217;s backward-word.</p></div>
  4511. </div>
  4512. <div class="sect2">
  4513. <h3 id="rl-beginning-of-line">rl-beginning-of-line</h3>
  4514. <div class="paragraph"><p>Move to the start of the line.</p></div>
  4515. <div class="paragraph"><p>This acts like readline&#8217;s beginning-of-line.</p></div>
  4516. </div>
  4517. <div class="sect2">
  4518. <h3 id="rl-delete-char">rl-delete-char</h3>
  4519. <div class="paragraph"><p>Delete the character after the cursor.</p></div>
  4520. <div class="paragraph"><p>This acts like readline&#8217;s delete-char.</p></div>
  4521. </div>
  4522. <div class="sect2">
  4523. <h3 id="rl-end-of-line">rl-end-of-line</h3>
  4524. <div class="paragraph"><p>Move to the end of the line.</p></div>
  4525. <div class="paragraph"><p>This acts like readline&#8217;s end-of-line.</p></div>
  4526. </div>
  4527. <div class="sect2">
  4528. <h3 id="rl-forward-char">rl-forward-char</h3>
  4529. <div class="paragraph"><p>Move forward a character.</p></div>
  4530. <div class="paragraph"><p>This acts like readline&#8217;s forward-char.</p></div>
  4531. </div>
  4532. <div class="sect2">
  4533. <h3 id="rl-forward-word">rl-forward-word</h3>
  4534. <div class="paragraph"><p>Move forward to the end of the next word.</p></div>
  4535. <div class="paragraph"><p>This acts like readline&#8217;s forward-word.</p></div>
  4536. </div>
  4537. <div class="sect2">
  4538. <h3 id="rl-kill-line">rl-kill-line</h3>
  4539. <div class="paragraph"><p>Remove chars from the cursor to the end of the line.</p></div>
  4540. <div class="paragraph"><p>This acts like readline&#8217;s kill-line.</p></div>
  4541. </div>
  4542. <div class="sect2">
  4543. <h3 id="rl-kill-word">rl-kill-word</h3>
  4544. <div class="paragraph"><p>Remove chars from the cursor to the end of the current word.</p></div>
  4545. <div class="paragraph"><p>This acts like readline&#8217;s kill-word.</p></div>
  4546. </div>
  4547. <div class="sect2">
  4548. <h3 id="rl-unix-filename-rubout">rl-unix-filename-rubout</h3>
  4549. <div class="paragraph"><p>Remove chars from the cursor to the previous path separator.</p></div>
  4550. <div class="paragraph"><p>This acts like readline&#8217;s unix-filename-rubout.</p></div>
  4551. </div>
  4552. <div class="sect2">
  4553. <h3 id="rl-unix-line-discard">rl-unix-line-discard</h3>
  4554. <div class="paragraph"><p>Remove chars backward from the cursor to the beginning of the line.</p></div>
  4555. <div class="paragraph"><p>This acts like readline&#8217;s unix-line-discard.</p></div>
  4556. </div>
  4557. <div class="sect2">
  4558. <h3 id="rl-unix-word-rubout">rl-unix-word-rubout</h3>
  4559. <div class="paragraph"><p>Remove chars from the cursor to the beginning of the word.</p></div>
  4560. <div class="paragraph"><p>This acts like readline&#8217;s unix-word-rubout. Whitespace is used as a word delimiter.</p></div>
  4561. </div>
  4562. <div class="sect2">
  4563. <h3 id="rl-yank">rl-yank</h3>
  4564. <div class="paragraph"><p>Paste the most recently deleted text.</p></div>
  4565. <div class="paragraph"><p>This acts like readline&#8217;s yank.</p></div>
  4566. </div>
  4567. <div class="sect2">
  4568. <h3 id="selection-drop">selection-drop</h3>
  4569. <div class="paragraph"><p>Drop selection and keep selection mode enabled.</p></div>
  4570. </div>
  4571. <div class="sect2">
  4572. <h3 id="selection-reverse">selection-reverse</h3>
  4573. <div class="paragraph"><p>Swap the stationary and moving end of the current selection.</p></div>
  4574. </div>
  4575. <div class="sect2">
  4576. <h3 id="selection-toggle">selection-toggle</h3>
  4577. <div class="paragraph"><p>Syntax: <code>:selection-toggle [<strong>--line</strong>]</code></p></div>
  4578. <div class="paragraph"><p>Toggle caret selection mode.</p></div>
  4579. <div class="sect3">
  4580. <h4 id="_optional_arguments_71">optional arguments</h4>
  4581. <div class="ulist"><ul>
  4582. <li>
  4583. <p>
  4584. <code><strong>-l</strong></code>, <code><strong>--line</strong></code>: Enables line-selection.
  4585. </p>
  4586. </li>
  4587. </ul></div>
  4588. </div>
  4589. </div>
  4590. </div>
  4591. </div>
  4592. <div class="sect1">
  4593. <h2 id="_debugging_commands">Debugging commands</h2>
  4594. <div class="sectionbody">
  4595. <div class="paragraph"><p>These commands are mainly intended for debugging. They are hidden if qutebrowser was started without the <code>--debug</code>-flag.</p></div>
  4596. <div class="tableblock">
  4597. <table rules="all"
  4598. width="75%"
  4599. frame="border"
  4600. cellspacing="0" cellpadding="4">
  4601. <caption class="title">Table 3. Quick reference</caption>
  4602. <col width="25%" />
  4603. <col width="75%" />
  4604. <thead>
  4605. <tr>
  4606. <th align="left" valign="top">Command</th>
  4607. <th align="left" valign="top">Description</th>
  4608. </tr>
  4609. </thead>
  4610. <tbody>
  4611. <tr>
  4612. <td align="left" valign="top"><p class="table"><a href="#debug-all-objects">debug-all-objects</a></p></td>
  4613. <td align="left" valign="top"><p class="table">Print a list of all objects to the debug log.</p></td>
  4614. </tr>
  4615. <tr>
  4616. <td align="left" valign="top"><p class="table"><a href="#debug-cache-stats">debug-cache-stats</a></p></td>
  4617. <td align="left" valign="top"><p class="table">Print LRU cache stats.</p></td>
  4618. </tr>
  4619. <tr>
  4620. <td align="left" valign="top"><p class="table"><a href="#debug-clear-ssl-errors">debug-clear-ssl-errors</a></p></td>
  4621. <td align="left" valign="top"><p class="table">Clear remembered SSL error answers.</p></td>
  4622. </tr>
  4623. <tr>
  4624. <td align="left" valign="top"><p class="table"><a href="#debug-console">debug-console</a></p></td>
  4625. <td align="left" valign="top"><p class="table">Show the debugging console.</p></td>
  4626. </tr>
  4627. <tr>
  4628. <td align="left" valign="top"><p class="table"><a href="#debug-crash">debug-crash</a></p></td>
  4629. <td align="left" valign="top"><p class="table">Crash for debugging purposes.</p></td>
  4630. </tr>
  4631. <tr>
  4632. <td align="left" valign="top"><p class="table"><a href="#debug-dump-history">debug-dump-history</a></p></td>
  4633. <td align="left" valign="top"><p class="table">Dump the history to a file in the old pre-SQL format.</p></td>
  4634. </tr>
  4635. <tr>
  4636. <td align="left" valign="top"><p class="table"><a href="#debug-dump-page">debug-dump-page</a></p></td>
  4637. <td align="left" valign="top"><p class="table">Dump the current page&#8217;s content to a file.</p></td>
  4638. </tr>
  4639. <tr>
  4640. <td align="left" valign="top"><p class="table"><a href="#debug-keytester">debug-keytester</a></p></td>
  4641. <td align="left" valign="top"><p class="table">Show a keytester widget.</p></td>
  4642. </tr>
  4643. <tr>
  4644. <td align="left" valign="top"><p class="table"><a href="#debug-log-capacity">debug-log-capacity</a></p></td>
  4645. <td align="left" valign="top"><p class="table">Change the number of log lines to be stored in RAM.</p></td>
  4646. </tr>
  4647. <tr>
  4648. <td align="left" valign="top"><p class="table"><a href="#debug-log-filter">debug-log-filter</a></p></td>
  4649. <td align="left" valign="top"><p class="table">Change the log filter for console logging.</p></td>
  4650. </tr>
  4651. <tr>
  4652. <td align="left" valign="top"><p class="table"><a href="#debug-pyeval">debug-pyeval</a></p></td>
  4653. <td align="left" valign="top"><p class="table">Evaluate a python string and display the results as a web page.</p></td>
  4654. </tr>
  4655. <tr>
  4656. <td align="left" valign="top"><p class="table"><a href="#debug-set-fake-clipboard">debug-set-fake-clipboard</a></p></td>
  4657. <td align="left" valign="top"><p class="table">Put data into the fake clipboard and enable logging, used for tests.</p></td>
  4658. </tr>
  4659. <tr>
  4660. <td align="left" valign="top"><p class="table"><a href="#debug-trace">debug-trace</a></p></td>
  4661. <td align="left" valign="top"><p class="table">Trace executed code via hunter.</p></td>
  4662. </tr>
  4663. <tr>
  4664. <td align="left" valign="top"><p class="table"><a href="#debug-webaction">debug-webaction</a></p></td>
  4665. <td align="left" valign="top"><p class="table">Execute a webaction.</p></td>
  4666. </tr>
  4667. </tbody>
  4668. </table>
  4669. </div>
  4670. <div class="sect2">
  4671. <h3 id="debug-all-objects">debug-all-objects</h3>
  4672. <div class="paragraph"><p>Print a list of all objects to the debug log.</p></div>
  4673. </div>
  4674. <div class="sect2">
  4675. <h3 id="debug-cache-stats">debug-cache-stats</h3>
  4676. <div class="paragraph"><p>Print LRU cache stats.</p></div>
  4677. </div>
  4678. <div class="sect2">
  4679. <h3 id="debug-clear-ssl-errors">debug-clear-ssl-errors</h3>
  4680. <div class="paragraph"><p>Clear remembered SSL error answers.</p></div>
  4681. </div>
  4682. <div class="sect2">
  4683. <h3 id="debug-console">debug-console</h3>
  4684. <div class="paragraph"><p>Show the debugging console.</p></div>
  4685. </div>
  4686. <div class="sect2">
  4687. <h3 id="debug-crash">debug-crash</h3>
  4688. <div class="paragraph"><p>Syntax: <code>:debug-crash [<em>typ</em>]</code></p></div>
  4689. <div class="paragraph"><p>Crash for debugging purposes.</p></div>
  4690. <div class="sect3">
  4691. <h4 id="_positional_arguments_73">positional arguments</h4>
  4692. <div class="ulist"><ul>
  4693. <li>
  4694. <p>
  4695. <code><em>typ</em></code>: either <em>exception</em> or <em>segfault</em>.
  4696. </p>
  4697. </li>
  4698. </ul></div>
  4699. </div>
  4700. </div>
  4701. <div class="sect2">
  4702. <h3 id="debug-dump-history">debug-dump-history</h3>
  4703. <div class="paragraph"><p>Syntax: <code>:debug-dump-history <em>dest</em></code></p></div>
  4704. <div class="paragraph"><p>Dump the history to a file in the old pre-SQL format.</p></div>
  4705. <div class="sect3">
  4706. <h4 id="_positional_arguments_74">positional arguments</h4>
  4707. <div class="ulist"><ul>
  4708. <li>
  4709. <p>
  4710. <code><em>dest</em></code>: Where to write the file to.
  4711. </p>
  4712. </li>
  4713. </ul></div>
  4714. </div>
  4715. </div>
  4716. <div class="sect2">
  4717. <h3 id="debug-dump-page">debug-dump-page</h3>
  4718. <div class="paragraph"><p>Syntax: <code>:debug-dump-page [<strong>--plain</strong>] <em>dest</em></code></p></div>
  4719. <div class="paragraph"><p>Dump the current page&#8217;s content to a file.</p></div>
  4720. <div class="sect3">
  4721. <h4 id="_positional_arguments_75">positional arguments</h4>
  4722. <div class="ulist"><ul>
  4723. <li>
  4724. <p>
  4725. <code><em>dest</em></code>: Where to write the file to.
  4726. </p>
  4727. </li>
  4728. </ul></div>
  4729. </div>
  4730. <div class="sect3">
  4731. <h4 id="_optional_arguments_72">optional arguments</h4>
  4732. <div class="ulist"><ul>
  4733. <li>
  4734. <p>
  4735. <code><strong>-p</strong></code>, <code><strong>--plain</strong></code>: Write plain text instead of HTML.
  4736. </p>
  4737. </li>
  4738. </ul></div>
  4739. </div>
  4740. </div>
  4741. <div class="sect2">
  4742. <h3 id="debug-keytester">debug-keytester</h3>
  4743. <div class="paragraph"><p>Show a keytester widget.</p></div>
  4744. </div>
  4745. <div class="sect2">
  4746. <h3 id="debug-log-capacity">debug-log-capacity</h3>
  4747. <div class="paragraph"><p>Syntax: <code>:debug-log-capacity <em>capacity</em></code></p></div>
  4748. <div class="paragraph"><p>Change the number of log lines to be stored in RAM.</p></div>
  4749. <div class="sect3">
  4750. <h4 id="_positional_arguments_76">positional arguments</h4>
  4751. <div class="ulist"><ul>
  4752. <li>
  4753. <p>
  4754. <code><em>capacity</em></code>: Number of lines for the log.
  4755. </p>
  4756. </li>
  4757. </ul></div>
  4758. </div>
  4759. </div>
  4760. <div class="sect2">
  4761. <h3 id="debug-log-filter">debug-log-filter</h3>
  4762. <div class="paragraph"><p>Syntax: <code>:debug-log-filter <em>filters</em></code></p></div>
  4763. <div class="paragraph"><p>Change the log filter for console logging.</p></div>
  4764. <div class="sect3">
  4765. <h4 id="_positional_arguments_77">positional arguments</h4>
  4766. <div class="ulist"><ul>
  4767. <li>
  4768. <p>
  4769. <code><em>filters</em></code>: A comma separated list of logger names. Can also be "none" to clear any existing filters.
  4770. </p>
  4771. </li>
  4772. </ul></div>
  4773. </div>
  4774. </div>
  4775. <div class="sect2">
  4776. <h3 id="debug-pyeval">debug-pyeval</h3>
  4777. <div class="paragraph"><p>Syntax: <code>:debug-pyeval [<strong>--file</strong>] [<strong>--quiet</strong>] <em>s</em></code></p></div>
  4778. <div class="paragraph"><p>Evaluate a python string and display the results as a web page.</p></div>
  4779. <div class="sect3">
  4780. <h4 id="_positional_arguments_78">positional arguments</h4>
  4781. <div class="ulist"><ul>
  4782. <li>
  4783. <p>
  4784. <code><em>s</em></code>: The string to evaluate.
  4785. </p>
  4786. </li>
  4787. </ul></div>
  4788. </div>
  4789. <div class="sect3">
  4790. <h4 id="_optional_arguments_73">optional arguments</h4>
  4791. <div class="ulist"><ul>
  4792. <li>
  4793. <p>
  4794. <code><strong>-f</strong></code>, <code><strong>--file</strong></code>: Interpret s as a path to file, also implies --quiet.
  4795. </p>
  4796. </li>
  4797. <li>
  4798. <p>
  4799. <code><strong>-q</strong></code>, <code><strong>--quiet</strong></code>: Don&#8217;t show the output in a new tab.
  4800. </p>
  4801. </li>
  4802. </ul></div>
  4803. </div>
  4804. <div class="sect3">
  4805. <h4 id="_note_20">note</h4>
  4806. <div class="ulist"><ul>
  4807. <li>
  4808. <p>
  4809. This command does not split arguments after the last argument and handles quotes literally.
  4810. </p>
  4811. </li>
  4812. <li>
  4813. <p>
  4814. With this command, <code>;;</code> is interpreted literally instead of splitting off a second command.
  4815. </p>
  4816. </li>
  4817. </ul></div>
  4818. </div>
  4819. </div>
  4820. <div class="sect2">
  4821. <h3 id="debug-set-fake-clipboard">debug-set-fake-clipboard</h3>
  4822. <div class="paragraph"><p>Syntax: <code>:debug-set-fake-clipboard [<em>s</em>]</code></p></div>
  4823. <div class="paragraph"><p>Put data into the fake clipboard and enable logging, used for tests.</p></div>
  4824. <div class="sect3">
  4825. <h4 id="_positional_arguments_79">positional arguments</h4>
  4826. <div class="ulist"><ul>
  4827. <li>
  4828. <p>
  4829. <code><em>s</em></code>: The text to put into the fake clipboard, or unset to enable logging.
  4830. </p>
  4831. </li>
  4832. </ul></div>
  4833. </div>
  4834. </div>
  4835. <div class="sect2">
  4836. <h3 id="debug-trace">debug-trace</h3>
  4837. <div class="paragraph"><p>Syntax: <code>:debug-trace [<em>expr</em>]</code></p></div>
  4838. <div class="paragraph"><p>Trace executed code via hunter.</p></div>
  4839. <div class="sect3">
  4840. <h4 id="_positional_arguments_80">positional arguments</h4>
  4841. <div class="ulist"><ul>
  4842. <li>
  4843. <p>
  4844. <code><em>expr</em></code>: What to trace, passed to hunter.
  4845. </p>
  4846. </li>
  4847. </ul></div>
  4848. </div>
  4849. <div class="sect3">
  4850. <h4 id="_note_21">note</h4>
  4851. <div class="ulist"><ul>
  4852. <li>
  4853. <p>
  4854. This command does not split arguments after the last argument and handles quotes literally.
  4855. </p>
  4856. </li>
  4857. <li>
  4858. <p>
  4859. With this command, <code>;;</code> is interpreted literally instead of splitting off a second command.
  4860. </p>
  4861. </li>
  4862. </ul></div>
  4863. </div>
  4864. </div>
  4865. <div class="sect2">
  4866. <h3 id="debug-webaction">debug-webaction</h3>
  4867. <div class="paragraph"><p>Syntax: <code>:debug-webaction <em>action</em></code></p></div>
  4868. <div class="paragraph"><p>Execute a webaction.</p></div>
  4869. <div class="paragraph"><p>Available actions: <a href="https://doc.qt.io/archives/qt-5.5/qwebpage.html#WebAction-enum">https://doc.qt.io/archives/qt-5.5/qwebpage.html#WebAction-enum</a> (WebKit) <a href="https://doc.qt.io/qt-5/qwebenginepage.html#WebAction-enum">https://doc.qt.io/qt-5/qwebenginepage.html#WebAction-enum</a> (WebEngine)</p></div>
  4870. <div class="sect3">
  4871. <h4 id="_positional_arguments_81">positional arguments</h4>
  4872. <div class="ulist"><ul>
  4873. <li>
  4874. <p>
  4875. <code><em>action</em></code>: The action to execute, e.g. MoveToNextChar.
  4876. </p>
  4877. </li>
  4878. </ul></div>
  4879. </div>
  4880. <div class="sect3">
  4881. <h4 id="_count_50">count</h4>
  4882. <div class="paragraph"><p>How many times to repeat the action.</p></div>
  4883. </div>
  4884. </div>
  4885. </div>
  4886. </div>
  4887. </div>
  4888. <div id="footnotes"><hr /></div>
  4889. <div id="footer">
  4890. <div id="footer-text">
  4891. Last updated
  4892. 2021-03-30 16:23:17 CEST
  4893. </div>
  4894. </div>
  4895. </body>
  4896. </html>