Package: koneko
Note: thehaskellbranch is an ongoing rewrite of koneko in Haskell using Brick, to enable a more responsive, less buggy, and easier to maintain codekonekoBrowse pixiv in the terminal using kitty's icat to display images (or ueberzug for all terminals)Gallery view 1Gallery view 2Image viewArtist search (artist profile picture on the left, 3 previews on right)View artists you're followingFor theicat, backend, thekittyterminal is needed. Alternatively, theueberzugbackend can be used in any terminal in X11 linux.Why the name Koneko?Koneko (こねこ) means kitten, which is whaticatis, a kitty+kittenFeaturesSee themanualfor more detailsView artist illustrations (eg)View a post (eg)View related images suggested by pixiv (eg: scroll down from the above example)View the artists that you are following (or any other user ID) (eg)Search for an artist/user (eg)View new illustrations from all the artists you are following (eg)View recommended illustrations (now called 'discovery') (eg)Save images individually in full resolution (PixivUtilwould be more suitable for batch download)Open post in browserBrowse the offline cacheFrequently used modes and searchesWhy?Terminal user interfaces are minimalist, fast, and doesn't load Javascript that slows down your entire browser or track youImage loading issomuch faster, especially if you don't delete the cacheI get 32 trackers on Pixiv. Plus, you have to disable ublock if you ever get logged outThe mobile app even directly tells you Google "and our 198 partners" "collect and use data"! Seeprompt 1,prompt 2and thislistof trackersTUIs make you coolTUIswith embedded picturesmake you even coolerTUIs embedded with pictures of cute anime girls make you the coolestKeyboard drivenFamiliar, vim-like key sequencesI use arch btwInstallationRequirementsPython 3.8+icat:It has been tested on kitty v0.17.2 onwards, but should work on older versionsLinux and macOSUeberzug: Linux with X11Dependencies on external programs (your responsibility to install them):xdg-mimeandupdate-desktop-databaseto handle the pixiv login callbackForupdate-desktop-database, try install thedesktop-file-utilspackage with your package managerxdg-open(linux) oropen(mac) for opening links in your browsercurlto download koneko's welcome and about images if they are missing (not needed unless if you deleted them)If koneko crashes (it shouldn't), it might be because pip didn't 'install' the welcome pictures, *and* the program failed to download them for some reason. Try:mkdir-p~/.local/share/koneko/picscurl-shttps://raw.githubusercontent.com/akazukin5151/koneko/master/pics/71471144_p0.png-o~/.local/share/koneko/pics/71471144_p0.pngcurl-shttps://raw.githubusercontent.com/akazukin5151/koneko/master/pics/79494300_p0.png-o~/.local/share/koneko/pics/79494300_p0.pngStepsSee also:manual installationIf not usingkitty, you have to use the ueberzug backend. Follow the instructions to install ueberzugherepip install koneko(or if you useconda...)Runkoneko. It will open a pixiv login page in your default browser and quit.Login to pixiv in your browser.If prompted, open thepixiv://link with "koneko pixiv login handler".If successful you should see a notification saying "Login finished!". If not, make a bug report athttps://github.com/akazukin5151/koneko/issues/Runlscat 1 8to get the recommended settings for your screen size.(Don't skip this step! Image display in the terminal is very sensitive to your settings!)If you get command not found, try adding$HOME/.local/binto your$PATHCopy the recommended settings to~/.config/koneko/config.ini. Seeexample_config.inifor referenceIf using ueberzug, adduse_ueberzug = onunder[experimental]in the configRunkonekoagain. Hopefully you don't see any error messages about login failing.Seeusagefor how to use.Usage and manualSee theMANUAL.mdFAQI'm having problems logging inTry these steps in order:If you successfully logged in, but the redirect did not work (the handler did not launch), ensurekoneko-url-loginis in your$PATHeg, look at where it is withwhereis koneko-url-loginand symlink it to$HOME/.local/bin/Update your system and reboot. No seriously, that's what worked for me.Try a different browserSet said different browser as your default browserMake a bug report athttps://github.com/akazukin5151/koneko/issues/for support and debuggingUse the original scripthereto get your refresh token. Copy the example config to~/.config/koneko, and add the linerefresh_token=XXXXunder the[Credentials]section.I'm having problems with lscatFor the best experience use the terminal in full screen, unless your screen is big enough. Moving and resizing it abruptly will not be good for icat, which is really kitty's problem not mine. icat moves the cursor around, which makes it prone to creating buggy behavior when text is printed. You can disable such text withprint_info = offunder[misc]ContributingSeeCONTRIBUTING.rstTrackers avoidedThis is a list of trackers present when you use the official pixiv website or app. koneko frees you from them.Nine trackers in the Android app, according toexodus:Amazon AdvertisementAMoAdGoogle AdsGoogle CrashLyticsGoogle DoubleClickGoogle Firebase AnalyticsIntegral Ad ScienceMoatTwitter MoPubAdvertisers from pixiv'sprivacy policy:LookerReproQualarooDDAI（Date Driven Advertising Initiative）YourAdChoicesRubicon Projecti-Mobile Co., Ltd.Akinasista CorporationAxel Mark Inc.AppLovinAmazon Japan G.K.AmoAd Inc.AOL Platforms Japan K.K.OpenXGoogle Inc.CRITEO K.K.CyberAgent, Inc.Geniee, Inc.Supership Inc.GMO AD Marketing Inc.F@N Communications, Inc.Facebook Inc.Fluct, Inc.Platform One Inc.MicroAd Inc.MoPub Inc.Yahoo! Japan CorporationUnited, Inc.株式会社ZucksPubMatic, Inc.Liftoff Mobile, Inc.Mobfox US LLCOneSignalSmaato, Inc.SMN株式会社株式会社アドインテ