? Editing: Post:21.body Save Delete Cancel
Content changed Sign & Publish new content

BinChan's ZeroNotes

Messy Notes about using ZeroNet and other things
All code published here are under CC-BY-SA licence, if not compatible, then MIT license X)

Follow in NewsfeedFollowing

TOC by date
TOC by tag
View in light theme

Latest comments:

Add new post


21 hours ago · 2 min read ·

Read more

Not found

The Ultimate ZeroNet Mobile Guide

on Jul 18, 2017 · 5 min read
tag: mobile tutorial zeronet

Table of Contents

How to Access:

  • Access by local wifi:
    If you are using ZeroNet inside home wifi, you can start zeronet with $ python2 /path/to/zeronet/zeronet.py --ui_retrict ip1 ip2 --ui_ip MY_Local_static_ip, ip1 ip2 is your mobile devices ip, My_Local_static_ip is your ZeroNet PC ip. Also you should bind your ip to your devices in the router config panel. [ref - Is it possible to install ZeroNet to a remote machine?]
    Also with a terminal app like ConnectBot or Termux, you can use the method mentioned by weakish:

    Alternatively, you can just start ZeroNet on remote machine as normal, without --ui_ip, UiPassword, reverse proxy, SSL, etc.
    And run this command at local machine:
    ssh -L 43110: -N username@remote
    Then you can just access on your local machine, securely.

  • Access by ZeroNet-kivy, it's also available on Google Play - ZeroNet4Android and on this zite ZeroNet Android by the author mkg20001.
    [Alert]: Currently ZeroNet-kivy stores sensitive data like your users.json as well as your private keys in the internal storge, which can be read by any other apps that have "internel storage" permission. So only use it for testing.

  • Access by Termux Android, here is a script to automate everything. greenlet clang patch has been merged to main stream, so you can change it to pip2 install greenlet in the script.

  • Access by Linuxdeploy Android, here is a rough tutorial for it.
    Note 1: When you can run ZeroNet with terminal, you can save battery by disabling Chart plugins (by renaming Chart to disabled-Chart), also you can start ZeroNet with --log_level INFO (Rev3321), suggested by Nofish)

  • Access by SSH tunnel (Spanish)

  • Access by clearnet proxy [List of working proxies]
    Note 1: if the list is blank or looks incomplete, check History for a complete version.
    Note 2: You can also Deploy ZeroNet to Heroku as a public proxy service in one click, and host it for free!

Mobile Improvement for Zites:

  • ZeroHello, ZeroMe and ZeroTalk are already mobile friendly.

  • ZeroBlog:

  • ZeroMail: [ZeroMail Mobile Simple Solution]
    For ZeroMail, the userstyle file is also provided here. If you prefer dark theme, check A Dark Theme for ZeroNet, the mobile improvement is included.

  • Note 1: Besides installing the css code with Stylish, you can directly add it to ZeroMail, create a file named all2.css in /path/to/zite/css/, copy the css code (except the first line which starts with @-moz-document and the last }) to it, then copy /path/to/zite/index.html to /path/to/zite/index2.html, inside index2.html, change the code

    <link rel="stylesheet" href="css/all.css" />


    <link rel="stylesheet" href="css/all.css" />
    <link rel="stylesheet" href="css/all2.css" />

    Then visit your zite and add index2.html at the end of the address. Like http:/ for ZeroMail, same with ZeroSites, ZeroBoard, etc.

Browser Recommendation (Android):

  • Icecat Mobile: 100% freesoftware. For me this one is with the best compatibility. But also the most laggy one... Icecat 52.3 is quite smooth, recommended.

  • Orfox from Guardian Project: Torbrowser for Android, so you can use it to block all harmful clearnet connections, but ZeroMe image upload doesn't work with this browser.
    You need to also install Orbot (Tor android) or Orfox will complain it when starting. After install it, enter about:config and search for no_proxy, add your remote machine ip and/or localhost like: 192.168.1.xxx:43110, If you want the Stylish add-on, you can also add the related add-on download address. I use the adb method instead: adb shell am start -a android.intent.action.VIEW -c android.intent.category.DEFAULT -d file:///mnt/sdcard/Download/ -n info.guardianproject.orfox/.App [ref]

  • Lightning Browser (recommended by Musickiller): brings really fast experience. Also ZeroChat doesn't work in this browser (Probably because it doesn't support JavaScript class, which was introduced in ES6 (ECMAScript 2015)).
    For privacy concern, you may like to change startpage and default search engine to Duckduckgo or Searx (the query url format is https://instance.url/?q=, I also add !go !ddg !wp !wd because Bing and Yahoo suck).
    Edit: Now part of ZeroNet uimedia.js code is ES6, like the notification (including mute, update button), and they don't work in Lightning Browser.

  • Note1: If the font size is too big or too small, you can change it in Settings.

  • Note2: Some zites may support mobile mode but the owner didn't add viewport setting to it, in this case, you can contact the owner to add "viewport": "width=device-width, initial-scale=1.0", in her/his content.json [ref], or force viewport in your browser: for Lightning Browser, uncheck Use wide viewport in Settings -> Display Settings. For Orfox or Icecat Mobile, search viewport in about:config, then change browser.viewport.desktopWidth to a smaller value, for me is 400.

Issues and Troubleshootings:

  • In some browser the "0" button is not clickable or need to tap twice, so use bookmark to access ZeroHello instead. Also the config panel is not very reactive, so you can try to refresh the screen (like for "This is my site" switcher) or tap the button more than one time to make it work.
  • [Fixed] On ZeroMe Mobile many image previews are blank. Weird bug, but you can still touch the screen twice to get the fullsize image.


  • Thank Nofish and other ZeroNet devs for this awesome project!

  • Thank Mkg20001 for the ZeroNet-kivy app!

  • Also thank every active ZeroNet fellows :3


[171117] Polish section - Mobile Improvement for Zites
[291017] Add alert for ZeroNet-kivy Android app. Thank shouko for sharing it.
[030817] Remove "Independent Scroll for Panels in ZeroHello".
[010817] Add ZeroHello Mobile, Minimal and Beautiful ZeroBlog Themed by ZAlex to Mobile Improvement for Zites. Remove viewport setting suggestion.
[240717] Change Note 1 to a harmless method. Add more explanation to browser recommendation.

0 Comment:

user_name1 day ago
Select user
  • Welcome to ZeroMessage!
This page is a snapshot of ZeroNet. Start your own ZeroNet for complete experience. Learn More