.gitignore

@@ -0,0 +1,24 @@
+# Gradle
+.gradle/
+build/
+*.class
+
+# Android
+local.properties
+*.apk
+*.ap_
+*.dex
+
+# IDE
+.idea/
+*.iml
+.vscode/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Build artifacts
+obj/
+*.o
+*.so

README.md

@@ -1,84 +1,109 @@
-<div align="center">
+<p align="center">
+  <img src="assets/banner.png" alt="nightd banner" width="400"/>
+</p>
 
-<img src="icon.png" width="128" height="128" alt="nightd icon">
+<h1 align="center">nightd</h1>
+<p align="center">
+  <em>screen dimmer for android tv</em><br>
+  <strong>keep your media playing while the screen goes dark</strong>
+</p>
 
-# nightd
+<p align="center">
-
+  <a href="https://github.com/sudoxnym/nightd/releases/latest"><img src="https://img.shields.io/github/v/release/sudoxnym/nightd?style=flat-square&color=00d4ff" alt="latest release"/></a>
-**screen dimmer for android tv**
+  <a href="https://github.com/sudoxnym/nightd/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-ff69b4?style=flat-square" alt="license"/></a>
-
+  <img src="https://img.shields.io/badge/android-7.0+-7B68EE?style=flat-square" alt="android 7.0+"/>
-[![GitHub release](https://img.shields.io/github/v/release/sudoxnym/nightd?color=00ffff&style=for-the-badge)](https://github.com/sudoxnym/nightd/releases/latest)
+</p>
-[![F-Droid](https://img.shields.io/badge/F--Droid-repo-b400ff?style=for-the-badge)](https://sudoxnym.github.io/fdroid-repo)
-[![License](https://img.shields.io/badge/license-MIT-ff00ff?style=for-the-badge)](LICENSE)
-
-*blacks out the display while keeping media playing. perfect for falling asleep to music without screen burn or light pollution.*
 
 ---
 
-</div>
+## what is this?
 
-## ✨ features
+nightd is a tiny android tv app that blacks out your screen while keeping your media playing. perfect for:
 
-- **dim mode** — single overlay layer for reduced brightness
+- **falling asleep to music/podcasts** - screen goes dark, audio keeps playing
-- **black mode** — full blackout while audio continues
+- **saving power on oled displays** - no burn-in, no wasted pixels
-- **toggle hotkey** — cycles through off → dim → black
+- **background audio** - cast audio without lighting up your room
-- **no root required** — just overlay permission
-- **tv remote friendly** — works with key mapper
 
-## 📥 install
+## modes
+
+| mode | what it does |
+|------|-------------|
+| **dim** | single overlay layer (~40% darker) |
+| **black** | 5 stacked layers = pitch black (android limits overlay opacity to 80%, so we stack 'em) |
+
+cycle order: `off → dim → black → off`
+
+## installation
+
+1. download the latest [nightd.apk](https://github.com/sudoxnym/nightd/releases/latest)
+2. sideload via adb: `adb install nightd.apk`
+3. grant "display over other apps" permission when prompted
+
+## usage
+
+### with key mapper (recommended)
+
+use [key mapper](https://github.com/keymapperorg/KeyMapper) to bind nightd to remote buttons:
+
+| action | intent |
+|--------|--------|
+| toggle | `com.sudox.nightd.TOGGLE` |
+| dim mode | `com.sudox.nightd.DIM` |
+| black mode | `com.sudox.nightd.BLACK` |
+| turn off | `com.sudox.nightd.OFF` |
+
+**package:** `com.sudox.nightd`  
+**service:** `com.sudox.nightd.NightdService`
+
+example: bind "zoom in" to toggle, "zoom out" to off.
+
+### with adb
 
-### option 1: github releases
 ```bash
-adb install nightd.apk
+# toggle (cycles through off → dim → black → off)
-```
+adb shell am startservice -a com.sudox.nightd.TOGGLE com.sudox.nightd/.NightdService
-[⬇️ download latest apk](https://github.com/sudoxnym/nightd/releases/latest)
 
-### option 2: f-droid repo
+# specific modes
-
+adb shell am startservice -a com.sudox.nightd.DIM com.sudox.nightd/.NightdService
-add this repo to f-droid or neostore:
+adb shell am startservice -a com.sudox.nightd.BLACK com.sudox.nightd/.NightdService
-```
+adb shell am startservice -a com.sudox.nightd.OFF com.sudox.nightd/.NightdService
-https://sudoxnym.github.io/fdroid-repo/repo
 ```
 
-<a href="https://sudoxnym.github.io/fdroid-repo">
+## how it works
-  <img src="https://fdroid.gitlab.io/artwork/badge/get-it-on.png" height="60">
-</a>
 
-## ⚙️ setup
+android limits overlay opacity to 80% per layer. to achieve true black, nightd stacks 5 layers:
 
-1. install the apk
+```
-2. open nightd and grant **"display over other apps"** permission
+0.8 × 0.8 × 0.8 × 0.8 × 0.8 = 0.032 (96.8% blocked)
-3. use [key mapper](https://github.com/keymapperorg/KeyMapper) to bind to a remote button
+```
 
-### key mapper config
+plus it sets screen brightness to 0 for good measure.
 
-set up an **activity** intent:
+## permissions
 
-| field | value |
+- **SYSTEM_ALERT_WINDOW** - required to draw overlay
-|-------|-------|
+- **FOREGROUND_SERVICE** - keeps the overlay running
-| action | `com.sudoxnym.nightd.TOGGLE` |
+- **WRITE_SETTINGS** - adjusts screen brightness (optional, gracefully fails)
-| package | `com.sudoxnym.nightd` |
-| class | `com.sudoxnym.nightd.ToggleActivity` |
 
-**available actions:**
+## building from source
-- `TOGGLE` — cycle through modes
-- `DIM` — single layer dim
-- `BLACK` — full blackout  
-- `OFF` — disable overlay
 
-## 🎮 usage
+```bash
+# clone
+git clone https://github.com/sudoxnym/nightd.git
+cd nightd
 
-- press your mapped button to cycle: **off → dim → black → off**
+# build (requires android ndk)
-- press **back** on remote to turn off overlay from any mode
+./gradlew assembleRelease
-- tap notification to disable
 
-## 📜 license
+# or use the aapt/d8/apksigner toolchain directly
+```
 
-MIT — do whatever you want with it
+## license
+
+MIT - do whatever you want with it.
 
 ---
 
-<div align="center">
+<p align="center">
-
+  <sub>built by <a href="https://github.com/sudoxnym">sudoxnym</a> for the sleep-deprived</sub>
-made by [sudoxnym](https://sudoxreboot.com) ⚡
+</p>
-
-</div>

app/build.gradle

@@ -0,0 +1,33 @@
+plugins {
+    id 'com.android.application'
+}
+
+android {
+    namespace 'com.sudox.nightd'
+    compileSdk 34
+
+    defaultConfig {
+        applicationId "com.sudox.nightd"
+        minSdk 21
+        targetSdk 34
+        versionCode 1
+        versionName "1.0"
+    }
+
+    buildTypes {
+        release {
+            minifyEnabled false
+        }
+        debug {
+            minifyEnabled false
+        }
+    }
+
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_1_8
+        targetCompatibility JavaVersion.VERSION_1_8
+    }
+}
+
+dependencies {
+}

app/src/main/AndroidManifest.xml

@@ -0,0 +1,62 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    package="com.sudox.nightd"
+    android:versionCode="2"
+    android:versionName="1.1">
+
+    <uses-sdk android:minSdkVersion="24" android:targetSdkVersion="35" />
+
+    <uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />
+    <uses-permission android:name="android.permission.WRITE_SETTINGS" />
+    <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
+    <uses-permission android:name="android.permission.FOREGROUND_SERVICE_SPECIAL_USE" />
+    <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
+
+    <uses-feature android:name="android.software.leanback" android:required="false" />
+    <uses-feature android:name="android.hardware.touchscreen" android:required="false" />
+
+    <application
+        android:allowBackup="false"
+        android:icon="@mipmap/ic_launcher"
+        android:label="nightd"
+        android:banner="@drawable/banner"
+        android:theme="@style/NightdTheme">
+
+        <service
+            android:name=".NightdService"
+            android:exported="true"
+            android:foregroundServiceType="specialUse">
+            <property
+                android:name="android.app.PROPERTY_SPECIAL_USE_FGS_SUBTYPE"
+                android:value="screen_overlay"/>
+            <intent-filter>
+                <action android:name="com.sudox.nightd.TOGGLE" />
+                <action android:name="com.sudox.nightd.ON" />
+                <action android:name="com.sudox.nightd.OFF" />
+                <action android:name="com.sudox.nightd.DIM" />
+                <action android:name="com.sudox.nightd.BLACK" />
+            </intent-filter>
+        </service>
+
+        <activity
+            android:name=".NightdActivity"
+            android:exported="true"
+            android:launchMode="singleTask"
+            android:theme="@android:style/Theme.Translucent.NoTitleBar">
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN" />
+                <category android:name="android.intent.category.LEANBACK_LAUNCHER" />
+            </intent-filter>
+        </activity>
+
+        <receiver
+            android:name=".BootReceiver"
+            android:exported="true">
+            <intent-filter>
+                <action android:name="android.intent.action.BOOT_COMPLETED" />
+            </intent-filter>
+        </receiver>
+
+    </application>
+
+</manifest>

app/src/main/java/com/sudox/nightd/BootReceiver.java

@@ -0,0 +1,15 @@
+package com.sudox.nightd;
+
+import android.content.BroadcastReceiver;
+import android.content.Context;
+import android.content.Intent;
+
+public class BootReceiver extends BroadcastReceiver {
+    @Override
+    public void onReceive(Context context, Intent intent) {
+        if (Intent.ACTION_BOOT_COMPLETED.equals(intent.getAction())) {
+            // Service ready to be triggered after boot
+            // Does not auto-start overlay, just ensures service is available
+        }
+    }
+}

app/src/main/java/com/sudox/nightd/NightdActivity.java

@@ -0,0 +1,42 @@
+package com.sudox.nightd;
+
+import android.app.Activity;
+import android.content.Intent;
+import android.net.Uri;
+import android.os.Bundle;
+import android.provider.Settings;
+
+public class NightdActivity extends Activity {
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        
+        // Check overlay permission first
+        if (!Settings.canDrawOverlays(this)) {
+            Intent intent = new Intent(
+                Settings.ACTION_MANAGE_OVERLAY_PERMISSION,
+                Uri.parse("package:" + getPackageName())
+            );
+            startActivityForResult(intent, 100);
+        } else {
+            toggleService();
+            finish();
+        }
+    }
+
+    @Override
+    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
+        super.onActivityResult(requestCode, resultCode, data);
+        if (requestCode == 100 && Settings.canDrawOverlays(this)) {
+            toggleService();
+        }
+        finish();
+    }
+
+    private void toggleService() {
+        Intent intent = new Intent(this, NightdService.class);
+        intent.setAction("com.sudox.nightd.TOGGLE");
+        startForegroundService(intent);
+    }
+}

app/src/main/java/com/sudox/nightd/NightdService.java

@@ -0,0 +1,149 @@
+package com.sudox.nightd;
+
+import android.app.Notification;
+import android.app.NotificationChannel;
+import android.app.NotificationManager;
+import android.app.PendingIntent;
+import android.app.Service;
+import android.content.Intent;
+import android.graphics.PixelFormat;
+import android.os.IBinder;
+import android.provider.Settings;
+import android.view.Gravity;
+import android.view.View;
+import android.view.WindowManager;
+import android.widget.FrameLayout;
+import java.util.ArrayList;
+import java.util.List;
+
+public class NightdService extends Service {
+    private static final String CHANNEL_ID = "nightd_channel";
+    private static final int NOTIFICATION_ID = 1;
+    
+    private WindowManager windowManager;
+    private List<View> overlayViews = new ArrayList<>();
+    private int currentMode = 0; // 0=off, 1=dim, 2=black
+    private int savedBrightness = 128;
+
+    @Override
+    public void onCreate() {
+        super.onCreate();
+        windowManager = (WindowManager) getSystemService(WINDOW_SERVICE);
+        createNotificationChannel();
+    }
+
+    @Override
+    public int onStartCommand(Intent intent, int flags, int startId) {
+        String action = intent == null ? null : intent.getAction();
+        
+        if ("com.sudox.nightd.DIM".equals(action)) {
+            setMode(1);
+        } else if ("com.sudox.nightd.BLACK".equals(action)) {
+            setMode(2);
+        } else if ("com.sudox.nightd.OFF".equals(action)) {
+            setMode(0);
+        } else {
+            // Toggle: off -> dim -> black -> off
+            setMode((currentMode + 1) % 3);
+        }
+        
+        return START_STICKY;
+    }
+
+    private void setMode(int mode) {
+        // Clear existing overlays
+        for (View v : overlayViews) {
+            try { windowManager.removeView(v); } catch (Exception e) {}
+        }
+        overlayViews.clear();
+        
+        if (mode == 0) {
+            // Off
+            try {
+                Settings.System.putInt(getContentResolver(), Settings.System.SCREEN_BRIGHTNESS, savedBrightness);
+            } catch (Exception e) {}
+            currentMode = 0;
+            stopForeground(true);
+            stopSelf();
+            return;
+        }
+        
+        if (Settings.canDrawOverlays(this) == false) {
+            Intent permIntent = new Intent(Settings.ACTION_MANAGE_OVERLAY_PERMISSION);
+            permIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+            startActivity(permIntent);
+            return;
+        }
+
+        // Save brightness on first activation
+        if (currentMode == 0) {
+            try {
+                savedBrightness = Settings.System.getInt(getContentResolver(), Settings.System.SCREEN_BRIGHTNESS);
+            } catch (Exception e) {}
+        }
+        
+        try {
+            Settings.System.putInt(getContentResolver(), Settings.System.SCREEN_BRIGHTNESS, 0);
+        } catch (Exception e) {}
+
+        startForeground(NOTIFICATION_ID, buildNotification(mode));
+
+        int layers = (mode == 1) ? 1 : 5;
+        for (int i = 0; i < layers; i++) {
+            FrameLayout layer = new FrameLayout(this);
+            layer.setBackgroundColor(0xFF000000);
+
+            WindowManager.LayoutParams params = new WindowManager.LayoutParams(
+                WindowManager.LayoutParams.MATCH_PARENT,
+                WindowManager.LayoutParams.MATCH_PARENT,
+                WindowManager.LayoutParams.TYPE_APPLICATION_OVERLAY,
+                WindowManager.LayoutParams.FLAG_NOT_FOCUSABLE |
+                WindowManager.LayoutParams.FLAG_NOT_TOUCHABLE |
+                WindowManager.LayoutParams.FLAG_LAYOUT_IN_SCREEN |
+                WindowManager.LayoutParams.FLAG_LAYOUT_NO_LIMITS |
+                WindowManager.LayoutParams.FLAG_FULLSCREEN,
+                PixelFormat.TRANSLUCENT
+            );
+            params.gravity = Gravity.TOP | Gravity.START;
+            params.screenBrightness = 0.0f;
+
+            try {
+                windowManager.addView(layer, params);
+                overlayViews.add(layer);
+            } catch (Exception e) { break; }
+        }
+        currentMode = mode;
+    }
+
+    private void createNotificationChannel() {
+        NotificationChannel channel = new NotificationChannel(
+            CHANNEL_ID, "nightd overlay", NotificationManager.IMPORTANCE_LOW
+        );
+        channel.setDescription("nightd screen overlay service");
+        getSystemService(NotificationManager.class).createNotificationChannel(channel);
+    }
+
+    private Notification buildNotification(int mode) {
+        Intent offIntent = new Intent(this, NightdService.class);
+        offIntent.setAction("com.sudox.nightd.OFF");
+        PendingIntent pendingIntent = PendingIntent.getService(this, 0, offIntent, PendingIntent.FLAG_IMMUTABLE);
+        
+        String modeText = (mode == 1) ? "dim" : "black";
+        return new Notification.Builder(this, CHANNEL_ID)
+            .setContentTitle("nightd: " + modeText)
+            .setContentText("tap to disable")
+            .setSmallIcon(android.R.drawable.ic_menu_view)
+            .setContentIntent(pendingIntent)
+            .setOngoing(true)
+            .build();
+    }
+
+    @Override
+    public IBinder onBind(Intent intent) { return null; }
+
+    @Override
+    public void onDestroy() {
+        setMode(0);
+        super.onDestroy();
+    }
+}

app/src/main/res/values/styles.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <style name="NightdTheme" parent="@android:style/Theme.NoTitleBar.Fullscreen">
+        <item name="android:windowBackground">@android:color/black</item>
+        <item name="android:colorBackground">@android:color/black</item>
+    </style>
+</resources>

build.gradle

@@ -0,0 +1,16 @@
+buildscript {
+    repositories {
+        google()
+        mavenCentral()
+    }
+    dependencies {
+        classpath 'com.android.tools.build:gradle:8.2.0'
+    }
+}
+
+allprojects {
+    repositories {
+        google()
+        mavenCentral()
+    }
+}

gradle.properties

@@ -0,0 +1,2 @@
+org.gradle.jvmargs=-Xmx1536m
+android.useAndroidX=false

settings.gradle

@@ -0,0 +1,2 @@
+rootProject.name = "nightd"
+include ':app'