Installation

Requirements

• Windows 10 or later
• Python 3.8+ (the installer handles this)

Install Everything

Download installer.bat and run it as Administrator. It installs:

• Netch 2 interpreter
• Netch Builder 2 (visual IDE)
• Netch Compiler (compile to .exe)
• Netch Package Manager
• Netch Package Creator
• Netch Launcher (desktop shortcut)

Manual Install

python installer.py

Verify

netch version

Hello World

Every Netch 2 file starts with <using.ntch>.

<using.ntch>

print("Hello, World!")

Save as hello.ntch and run:

netch run hello.ntch

Your First Window App

<using.ntch>
use window
window.title("My First App")
window.size(600, 400)
window.center

label("Welcome to NetchLang 2!")
button("Say Hello") action print("Hello!")

Basic Syntax

File Header

<using.ntch>  # first line of every .ntch file

Comments

# This is a comment
print("Hello")  # inline comment

Variables

name  = "Alice"
age   = 25
score = 98.5
on    = true

Indentation

Use 4 spaces to indent blocks. Tabs work too.

if age > 18
    print("Adult")
else
    print("Minor")

Variables & Types

Type Utils

typeof(x)          # "text", "number", "bool", "list"
tonumber("42")     # 42
totext(42)         # "42"
isnumber("hi")    # false
isempty("")        # true

Control Flow

If / Else

if score > 90
    print("A grade")
else
    print("B grade")

While

x = 0
while x < 5
    print(x)
    x = x + 1

Repeat

repeat 3
    print("Hello!")

For Loop

for i from 1 to 10
    print(i)

Foreach

fruits = list.new("Apple", "Banana", "Orange")
foreach fruit in fruits
    print(fruit)

If Button Clicked

use window
button("Say Hi")
if button("Say Hi") clicked
    print("Hi!")

Functions

function greet
    print("Hello from a function!")

run(greet)

Lists

colors = list.new("red", "green", "blue")
list.add("colors", "purple")
print(list.length("colors"))   # 4
foreach c in colors
    print(c)

Strings

Math

File System

Windows

Widgets

Reading Values

getinput("mybox")       # textbox / password
getchecked("mycheck") # checkbox → true/false
getradio("group")     # radio → selected value
getdropdown("mydrop") # dropdown → selected item
getslider("myslider") # slider → number
getlist("mylist")     # listbox → selected item

Dialogs

dialog.info("Title", "Message")
dialog.error("Title", "Message")
answer = dialog.ask("Confirm", "Sure?")  # true/false
text   = dialog.input("Title", "Prompt:")
file   = dialog.file("Open file")

Canvas

<using.ntch>
use window
canvas.new("c", 500, 300, "#0d0d14")
canvas.rect("c", 50, 50, 200, 150, "#b8ff00")
canvas.circle("c", 350, 120, 60, "#7c6af7")
canvas.text("c", 250, 20, "My Canvas", "#ffffff")

Dark Mode

<using.ntch>
dark:true
use window
window.title("Dark App")
label("Everything goes dark automatically!")

HTTP & Servers

Response stored in last.response after any request.

Email

email.send("you@gmail.com", "app-password",
           "them@gmail.com", "Subject", "Body")

email.send.html("you@gmail.com", "pass",
    "them@gmail.com", "Subject", "<h1>Hello!</h1>")

Sound

sound.play("alert.wav")
sound.stop()

Video

video.play("clip.mp4")
video.play("clip.mp4", "myvid")
video.stop("myvid")

Text-to-Speech

tts.say("Hello from NetchLang 2!")
tts.say("Faster", 220)
tts.save("Hello!", "output.mp3")

Voice Recognition

text = voice.listen()         # online (Google)
text = voice.listen.offline()  # offline (PocketSphinx)
print(text)

PDF

pdf.create("report.pdf", "My Report")
pdf.heading("Welcome to NetchLang 2")
pdf.text("Made with Netch 2.")
pdf.text("Big text", 18)
pdf.newpage()
pdf.save()

Package Manager

<using.ntch>
importpkg customwindowtitle
# or load everything installed:
import all pkgs

customwindowtitle Package

netch pkg install customwindowtitle

<using.ntch>
importpkg customwindowtitle
use window
windowtitle("title.nframetchpng", "My App")

# with custom close/min/max buttons:
windowtitle("title.nframetchpng", "My App",
    "close.png", "min.png", "max.png")

ainetchintegration Package

netch pkg install ainetchintegration

<using.ntch>
importpkg ainetchintegration
ai.key("your-anthropic-key")
ai.system("You are a helpful assistant")
dark:true
use window
heading("AI Chat")
textbox("q", 40, "Ask something...")
button("Ask AI") action print(ai.ask(getinput("q")))

controllocalapps Package

netch pkg install controllocalapps

<using.ntch>
importpkg controllocalapps
flag -- I_KNOW_WHAT_IM_DOING
confirmation = PRODUCTION_STATE
for warning "THIS MAY INTERFERE WITH APPS" ignore.flag set
app = "C:/myapp.exe"
local.app.system app set to VARIABLE"app"
local.app.launch app

Netch Builder 2

python netch_builder.py

Features

• Drag-and-drop canvas — drag widgets from the palette onto the canvas, move them anywhere
• Double-click to edit — double-click any widget to edit its properties
• Auto code generation — the code updates live as you design
• Code editor mode — switch between visual and code view
• Syntax highlighting for all Netch 2 keywords and functions
• Run from the builder — output shown in the built-in console
• Compile to EXE from the toolbar
• Package Manager integration
• Package Creator integration

Compile to EXE

netch compiletoexe myapp.ntch
netch compiletoexe myapp.ntch --name "My App"
netch compiletoexe myapp.ntch --icon myapp.ico
netch compiletoexe myapp.ntch --output C:/releases

CLI Reference

Plugin System

Load your own Python extensions into any Netch script.

Create a Plugin

# myplugin.py
def say_hello(args):
    name = args[0] if args else "World"
    print(f"Hello, {name}!")

NETCH_BUILTINS = {"myplugin.hello": say_hello}

Use It

<using.ntch>
plugin.load("myplugin.py")
plugin.call("myplugin.hello", "Alice")