; erkSearch - IRC network finder for mIRC ; --------------------------------------- ; A dialog that searches the erkstats public API for IRC networks and lets you ; connect with a click. No API key needed - the API is public. ; ; Install: copy this file somewhere, then in mIRC: /load -rs erksearch.mrc ; Open: type /erksearch (or use the "erkSearch" item on the menu bar) ; ; Needs mIRC 7.56 or newer (for $urlget). Search finds networks by keyword ; (names, descriptions, tags and languages), best match first; put tag:name in ; the box to list the networks with that tag. Leave the box blank and press ; Search to browse the top networks. Sort orders them (incl. by age), Show sets ; how many, and Language filters to one language. Results are fetched in pages so ; any Show count works. ; ; Version 1.2 alias erksearch { if ($version < 7.56) { echo -a * erkSearch needs mIRC 7.56 or newer (yours is $version ). return } if (!$dialog(erksearch)) dialog -m erksearch erksearch } ; ---- the dialog ---------------------------------------------------------------- dialog erksearch { title "erkSearch - IRC network finder" size -1 -1 470 296 option dbu text "Search (blank = top)", 10, 8 6 130 8 edit "", 1, 8 16 130 12, autohs button "Search", 2, 142 15 44 14, default flat text "Language", 15, 194 6 70 8 edit "", 14, 194 16 70 12, autohs text "Sort", 11, 270 6 108 8 combo 9, 270 16 108 120, drop text "Show", 12, 384 6 44 8 combo 13, 384 16 44 120, drop ; left: results list 3, 8 40 224 210, size vsbar ; right: details panel (a grid of label + value controls - naturally aligned) box "Network details", 40, 240 34 224 216 text "Network", 20, 248 48 54 8 text "-", 21, 306 48 150 8 text "Server", 22, 248 62 54 8 text "-", 23, 306 62 150 8 text "Users", 24, 248 76 54 8 text "-", 25, 306 76 150 8 text "30-day avg", 26, 248 90 54 8 text "-", 27, 306 90 150 8 text "Language", 28, 248 104 54 8 text "-", 29, 306 104 150 8 text "Founded", 30, 248 118 54 8 text "-", 31, 306 118 150 8 text "Verified", 32, 248 132 54 8 text "-", 33, 306 132 150 8 text "Website", 37, 248 146 54 8 text "-", 38, 306 146 150 8 text "Connect", 34, 248 160 54 8 text "-", 35, 306 160 150 8 edit "", 36, 248 176 208 68, read multi vsbar button "Connect", 5, 8 256 92 14, flat button "Website", 7, 106 256 92 14, flat button "Close", 8, 394 256 70 14, ok flat text "Ready.", 4, 8 276 380 9 } on *:dialog:erksearch:init:0: { did -a erksearch 9 Best match did -a erksearch 9 Most users did -a erksearch 9 30-day average did -a erksearch 9 Most channels did -a erksearch 9 Most servers did -a erksearch 9 Name (A-Z) did -a erksearch 9 Newest did -a erksearch 9 Oldest did -c erksearch 9 1 did -a erksearch 13 10 did -a erksearch 13 20 did -a erksearch 13 50 did -a erksearch 13 100 did -c erksearch 13 1 erksearch.detailreset did -f erksearch 1 erksearch.status Type a keyword (or tag:name), or just press Search to see the biggest networks. } on *:dialog:erksearch:sclick:2: erksearch.search on *:dialog:erksearch:sclick:3: erksearch.showdetails on *:dialog:erksearch:dclick:3: erksearch.connect on *:dialog:erksearch:sclick:5: erksearch.connect on *:dialog:erksearch:sclick:7: erksearch.website on *:dialog:erksearch:close:*: { if ($hget(erksearch.rows)) hfree erksearch.rows unset %erksearch.base %erksearch.target %erksearch.got %erksearch.req %erksearch.also } ; ---- menu bar entry ------------------------------------------------------------ menu menubar { erkSearch : erksearch } ; ---- search: set up paging + fire the first page ------------------------------- alias -l erksearch.search { ; pull a tag:name word out of the box; the rest is the keyword search var %in = $did(erksearch, 1).text, %q, %tag, %i = 1 while ($gettok(%in, %i, 32) != $null) { var %w = $gettok(%in, %i, 32) if ($regex(erktag, %w, /^tag:#?(.+)$/i)) %tag = $regml(erktag, 1) else %q = %q %w inc %i } var %lang = $did(erksearch, 14).text var %sd = $erksearch.sortkey var %sort = $gettok(%sd, 1, 32) var %dir = $gettok(%sd, 2, 32) var %base = https://erkstats.info/api/v1/public var %url if (($len(%q) >= 2) || (%tag != $null)) { var %url = %base $+ /search/network?sort= $+ %sort $+ &dir= $+ %dir if (%q != $null) var %url = %url $+ &q= $+ $erksearch.urlenc(%q) if (%tag != $null) var %url = %url $+ &tag= $+ $erksearch.urlenc(%tag) erksearch.status Searching for $iif(%q != $null, " $+ %q $+ ") $iif(%tag != $null, tag %tag) ... } elseif (%q == $null) { ; browsing has no "best match": list the biggest first if (%sort == relevance) var %sort = users var %url = %base $+ /networks?sort= $+ %sort $+ &dir= $+ %dir erksearch.status Loading networks ... } else { erksearch.status Enter 2+ characters, or leave the box blank to browse the top networks. return } if (%lang != $null) var %url = %url $+ &lang= $+ $erksearch.urlenc(%lang) set %erksearch.base %url set %erksearch.target $erksearch.limit set %erksearch.got 0 unset %erksearch.also did -r erksearch 3 erksearch.detailreset if ($hget(erksearch.rows)) hfree erksearch.rows hmake erksearch.rows 700 erksearch.fetchpage } ; request the next page (limit/offset), sized to what's still wanted alias -l erksearch.fetchpage { var %want = $calc(%erksearch.target - %erksearch.got) if (%want <= 0) return var %page = $iif(%want > 20, 20, %want) var %url = %erksearch.base $+ &limit= $+ %page $+ &offset= $+ %erksearch.got ; name ourselves, so erkstats can tell this script's traffic apart bset -t &erkhdr 1 X-Client: erksearch-mirc/1.2 var %id = $urlget(%url,gb,&erksearch,erksearch.gotdata,&erkhdr) if (!%id) erksearch.status Could not start the request (is this mIRC 7.56+?). set %erksearch.req %id } ; ---- the $urlget callback (must be a GLOBAL alias - mIRC calls it async) -------- ; Parses one page, appends its networks, then chains the next page until we have ; the requested count (or the server runs out). A page is bigger than mIRC's ; longest string, so each network is cut out of the &binvar on its own: they ; all start with {"slug": and run to the next one. alias erksearch.gotdata { ; an older search still finishing after a new one started: ignore it if ($1 != %erksearch.req) || (!$dialog(erksearch)) return var %size = $bvar(&erksearch, 0) if ($urlget($1).state != ok) || (!%size) { var %why = $gettok($urlget($1).reply, 1, 13) erksearch.status Could not reach erkstats.info $iif(%why != $null, - %why) return } var %head = $bvar(&erksearch, 1, 600).text if ($regex(erkerr, %head, /"error":"((?:[^"\\]|\\.)*)"/)) { erksearch.status Server: $erksearch.unesc($regml(erkerr, 1)) return } var %total = 0 if ($regex(erkcnt, %head, /"count":(\d+)/)) %total = $regml(erkcnt, 1) ; the words the search widened to (word forms, related words): "a","b" -> a, b if (%erksearch.got == 0) && ($regex(erkalso, %head, /"also_matching":\[("[^\]]*)\]/)) { set %erksearch.also $remove($replace($regml(erkalso, 1), $+(",$chr(44),"), $+($chr(44),$chr(32))), ") } var %needle = $chr(123) $+ "slug": var %count = 0 var %pos = $bfind(&erksearch, 1, %needle).text while (%pos) { inc %count var %next = $bfind(&erksearch, $calc(%pos + 1), %needle).text var %end = $iif(%next, $calc(%next - 1), %size) var %o = $utfdecode($bvar(&erksearch, %pos, $calc(%end - %pos + 1)).text) %pos = %next var %name, %server, %port, %tls = 0, %users, %avg, %lang, %verified = 0, %web, %founded, %blurb, %uri if ($regex(%o, /"name":"((?:[^"\\]|\\.)*)"/)) %name = $erksearch.unesc($regml(1)) if ($regex(%o, /"server":"((?:[^"\\]|\\.)*)"/)) %server = $regml(1) if ($regex(%o, /"port":(\d+)/)) %port = $regml(1) if ($regex(%o, /"tls":true/)) %tls = 1 if ($regex(%o, /"users":(\d+)/)) %users = $regml(1) if ($regex(%o, /"users_30d_avg":(\d+)/)) %avg = $regml(1) if ($regex(%o, /"language":"((?:[^"\\]|\\.)*)"/)) %lang = $erksearch.unesc($regml(1)) if ($regex(%o, /"verified":true/)) %verified = 1 if ($regex(%o, /"website":"((?:[^"\\]|\\.)*)"/)) %web = $erksearch.unesc($regml(1)) if ($regex(%o, /"founded":(\d+)/)) %founded = $regml(1) if ($regex(%o, /"blurb":"((?:[^"\\]|\\.)*)"/)) %blurb = $erksearch.unesc($regml(1)) if ($regex(%o, /"connect_uri":"((?:[^"\\]|\\.)*)"/)) %uri = $erksearch.unesc($regml(1)) if (%server == $null) continue inc %erksearch.got var %k = %erksearch.got hadd erksearch.rows $+(%k,.name) %name hadd erksearch.rows $+(%k,.server) %server hadd erksearch.rows $+(%k,.port) %port hadd erksearch.rows $+(%k,.tls) %tls hadd erksearch.rows $+(%k,.users) %users hadd erksearch.rows $+(%k,.avg) %avg hadd erksearch.rows $+(%k,.lang) %lang hadd erksearch.rows $+(%k,.verified) %verified hadd erksearch.rows $+(%k,.web) %web hadd erksearch.rows $+(%k,.founded) %founded hadd erksearch.rows $+(%k,.blurb) %blurb hadd erksearch.rows $+(%k,.uri) %uri var %ln = %name var %ln = %ln - $iif(%users != $null, $erksearch.comma(%users), ?) users if (%lang != $null) var %ln = %ln - %lang if (%founded != $null) var %ln = %ln - %founded did -a erksearch 3 %ln } ; chain the next page if we still want more and the server has more if ((%erksearch.got < %erksearch.target) && (%erksearch.got < %total) && (%count > 0)) { erksearch.status Loaded %erksearch.got of %total $+ ... erksearch.fetchpage } else { erksearch.status Showing %erksearch.got of %total network(s). $iif(%erksearch.also != $null, Also matching: %erksearch.also $+ .) Click a row for details; double-click to join. } } ; ---- details panel on selection ------------------------------------------------ alias -l erksearch.showdetails { var %n = $did(erksearch, 3).sel if (!%n) || (!$hget(erksearch.rows, $+(%n,.server))) { erksearch.detailreset return } var %tls = $hget(erksearch.rows, $+(%n,.tls)) var %users = $hget(erksearch.rows, $+(%n,.users)) var %avg = $hget(erksearch.rows, $+(%n,.avg)) did -o erksearch 21 1 $hget(erksearch.rows, $+(%n,.name)) did -o erksearch 23 1 $hget(erksearch.rows, $+(%n,.server)) $+ : $+ $hget(erksearch.rows, $+(%n,.port)) $iif(%tls == 1, (TLS), (plain)) did -o erksearch 25 1 $iif(%users != $null, $erksearch.comma(%users) online, -) did -o erksearch 27 1 $iif(%avg != $null, $erksearch.comma(%avg), -) did -o erksearch 29 1 $iif($hget(erksearch.rows, $+(%n,.lang)) != $null, $hget(erksearch.rows, $+(%n,.lang)), -) did -o erksearch 31 1 $iif($hget(erksearch.rows, $+(%n,.founded)) != $null, $hget(erksearch.rows, $+(%n,.founded)), -) did -o erksearch 33 1 $iif($hget(erksearch.rows, $+(%n,.verified)) == 1, Yes, No) did -o erksearch 38 1 $iif($hget(erksearch.rows, $+(%n,.web)) != $null, $hget(erksearch.rows, $+(%n,.web)), -) did -o erksearch 35 1 $hget(erksearch.rows, $+(%n,.uri)) did -r erksearch 36 if ($hget(erksearch.rows, $+(%n,.blurb)) != $null) did -a erksearch 36 $hget(erksearch.rows, $+(%n,.blurb)) } ; blank every value control + the blurb box alias -l erksearch.detailreset { var %ids = 21 23 25 27 29 31 33 38 35, %i = 1 while ($gettok(%ids, %i, 32) != $null) { did -o erksearch $gettok(%ids, %i, 32) 1 - inc %i } did -r erksearch 36 } ; ---- connect to the selected network ------------------------------------------- alias -l erksearch.connect { var %n = $did(erksearch, 3).sel if (!%n) || (!$hget(erksearch.rows, $+(%n,.server))) { erksearch.status Select a network first. return } var %server = $hget(erksearch.rows, $+(%n,.server)) var %port = $hget(erksearch.rows, $+(%n,.port)) var %name = $hget(erksearch.rows, $+(%n,.name)) var %pp = $iif($hget(erksearch.rows, $+(%n,.tls)) == 1, + $+ %port, %port) erksearch.status Connecting to %name ( %server $+ : $+ %port ) ... server -m %server %pp } ; ---- open the selected network's website --------------------------------------- alias -l erksearch.website { var %n = $did(erksearch, 3).sel if (!%n) return var %web = $hget(erksearch.rows, $+(%n,.web)) if (%web != $null) url -a %web else erksearch.status No website listed for this network. } ; ---- helpers ------------------------------------------------------------------- alias -l erksearch.status did -o erksearch 4 1 $1- ; map the Sort dropdown to an API sort key + direction (" ") alias -l erksearch.sortkey { var %s = $did(erksearch, 9).sel if (%s == 2) return users desc if (%s == 3) return users_30d desc if (%s == 4) return channels desc if (%s == 5) return servers desc if (%s == 6) return name asc if (%s == 7) return founded desc if (%s == 8) return founded asc return relevance desc } ; the Show dropdown -> how many results to load (default 10) alias -l erksearch.limit { var %s = $did(erksearch, 13).seltext if (%s isnum) return %s return 10 } ; percent-encode a query as UTF-8; leaves unreserved chars intact. Word by word, ; since mIRC can't hold a lone space in a variable: words are joined with %20. alias -l erksearch.urlenc { var %o, %w = 1, %words = $numtok($1-, 32) while (%w <= %words) { var %s = $utfencode($gettok($1-, %w, 32)), %i = 1, %c while (%i <= $len(%s)) { %c = $mid(%s, %i, 1) if ($regex(%c, /^[A-Za-z0-9._~-]$/)) %o = %o $+ %c else %o = %o $+ $chr(37) $+ $base($asc(%c),10,16,2) inc %i } if (%w < %words) %o = %o $+ $chr(37) $+ 20 inc %w } return %o } ; unescape a JSON string value (handles \" \\ and control-char escapes) alias -l erksearch.unesc return $regsubex($1-, /\\(.)/g, $erksearch.unesc1(\1)) alias -l erksearch.unesc1 { if ($1 == n) return $chr(32) if ($1 == t) return $chr(32) if ($1 == r) || ($1 == b) || ($1 == f) return return $1 } ; group digits with commas: 31490 -> 31,490 alias -l erksearch.comma { if ($1 == $null) return $1 return $regsubex($1, /(\d)(?=(\d\d\d)+$)/g, \1 $+ $chr(44)) } on *:load: { echo -a * erkSearch loaded. Type /erksearch (or use the erkSearch menu-bar item) to search for IRC networks. }