INI-JSONkonverter

Praxis · 9 Min. Lesezeit

INI-Datei öffnen und bearbeiten: Windows, Mac, Browser und Editor

INI-Datei öffnen und bearbeiten leicht gemacht: Schritt für Schritt mit Notepad, TextEdit, VS Code und im Browser. Mit Hinweisen zu Endung, UTF-8-Encoding und den häufigsten Fehlern beim Bearbeiten.

Jan-Tristan Rudat
Jan-Tristan Rudat Veröffentlicht Geprüft

Kurz gesagt

Eine INI-Datei ist eine einfache Textdatei und lässt sich mit jedem Texteditor öffnen, unter Windows mit dem Editor (Notepad), auf dem Mac mit TextEdit, plattformübergreifend mit VS Code oder Notepad++. Beim Bearbeiten ändern Sie nur die Werte rechts vom Gleichheitszeichen, lassen Sektionsköpfe und Schlüsselnamen unverändert und speichern als reinen Text im Zeichensatz UTF-8. Die zwei häufigsten Fehler sind ein falsches Encoding (kaputte Umlaute) und eine versehentlich angehängte Endung .txt. Wer die Struktur prüfen will, fügt die Datei in unseren INI-zu-JSON-Konverter ein, der ungültige Zeilen sofort meldet.

Was eine INI-Datei ist und warum sie so leicht zu öffnen ist

Eine INI-Datei ist eine textbasierte Konfigurationsdatei. Der Name geht auf das englische initialization zurück, denn das Format diente ursprünglich dazu, Windows-Programme beim Start mit Einstellungen zu versorgen. Im Inneren ist eine INI-Datei nichts weiter als schlichter Text, organisiert in Sektionen (in eckigen Klammern, etwa [Anzeige]) und darunter in Schlüssel-Wert-Paaren der Form schlüssel=wert. Kommentarzeilen beginnen mit einem Semikolon ; oder einer Raute #.

Genau weil es reiner Text ist, brauchen Sie zum Öffnen kein Spezialprogramm. Jeder Texteditor reicht. Das ist der entscheidende Unterschied zu Formaten wie XLSX oder DOCX, die ein bestimmtes Programm voraussetzen. Eine typische INI-Datei sieht so aus:

; Konfiguration der Anwendung
[allgemein]
sprache=de
autostart=true

[anzeige]
breite=1920
höhe=1080
vollbild=false

Wenn Sie diese Struktur verstehen, ist das Bearbeiten halb gewonnen. Eine ausführliche Einführung in Aufbau und Geschichte finden Sie im Ratgeber Was ist eine INI-Datei.

INI-Datei unter Windows öffnen und bearbeiten

Unter Windows ist die .ini-Endung meist mit dem Editor (Notepad) verknüpft. Ein Doppelklick öffnet die Datei dann direkt. Trotzdem lohnt sich der bewusste Weg, gerade wenn die Datei zu einem Programm gehört, das gerade läuft.

Mit dem Windows-Editor (Notepad)

  1. Klicken Sie mit der rechten Maustaste auf die INI-Datei und wählen Sie Öffnen mit, Editor.
  2. Falls der Editor nicht angeboten wird, wählen Sie Andere App auswählen und suchen Notepad in der Liste.
  3. Bearbeiten Sie die gewünschten Werte. Speichern Sie anschließend mit Strg + S.
  4. Achten Sie im Speichern-Dialog unten auf das Feld Codierung und wählen Sie dort UTF-8.

Der moderne Windows-Editor zeigt das gewählte Encoding inzwischen in der Statusleiste am unteren Rand an. Liegt dort etwas anderes als UTF-8, etwa ANSI, stellen Sie es beim Speichern um, sonst riskieren Sie kaputte Umlaute.

Mit erhöhten Rechten für geschützte Verzeichnisse

Liegt die INI-Datei in einem geschützten Ordner wie C:\Programme oder C:\Windows, verweigert Windows das Speichern für normale Benutzer. Starten Sie den Editor dann als Administrator: Suchen Sie im Startmenü nach Editor, klicken Sie mit der rechten Maustaste und wählen Als Administrator ausführen. Öffnen Sie die Datei anschließend über Datei, Öffnen aus dem Editor heraus. Bearbeiten Sie Systemdateien nur, wenn Sie wissen, was Sie tun, und legen Sie vorher immer eine Kopie an.

INI-Datei auf dem Mac öffnen und bearbeiten

Auf dem Mac liefert macOS das Programm TextEdit mit. Es hat eine Eigenheit: Standardmäßig arbeitet es im Rich-Text-Modus und würde eine Datei mit Formatierung speichern. Das müssen Sie verhindern, sonst ist die INI-Datei beschädigt.

  1. Öffnen Sie TextEdit und wählen Sie in den Einstellungen unter Format die Option Reiner Text.
  2. Öffnen Sie die INI-Datei über Ablage, Öffnen. Falls TextEdit sie als formatierten Text deutet, erzwingen Sie reinen Text über Format, In reinen Text umwandeln.
  3. Bearbeiten Sie die Werte und speichern Sie mit Befehl + S.
  4. Achten Sie im Speichern-Dialog auf die Codierung UTF-8 und darauf, dass die Endung .ini erhalten bleibt.

Wer regelmäßig mit Konfigurationsdateien arbeitet, ist auf dem Mac mit einem Code-Editor besser bedient. Auch das macOS-Terminal mit nano dateiname.ini ist eine schnelle, zuverlässige Option, gerade für Dateien ohne grafische Oberfläche.

Die besten Editoren im Überblick

Nicht jeder Editor ist gleich gut für INI-Dateien geeignet. Diese Übersicht hilft bei der Wahl:

Editor Plattform Besonders geeignet für
Editor (Notepad) Windows Schnelles Öffnen und kleine Änderungen
Notepad++ Windows Syntax-Highlighting, Encoding-Anzeige
TextEdit Mac Bordmittel, nur im Modus Reiner Text
VS Code Windows, Mac, Linux Highlighting, Encoding, große Dateien
nano / vim Terminal (alle) Server, Dateien ohne Oberfläche

Für gelegentliche Änderungen reicht der Bordmittel-Editor. Wer öfter mit Konfigurationen arbeitet, profitiert von Notepad++ oder VS Code: Beide färben Sektionen, Schlüssel und Kommentare unterschiedlich ein, zeigen das Encoding deutlich an und warnen bei kaputten Zeichen. Office-Programme wie Word oder Excel sind dagegen ungeeignet, weil sie Formatierungen einfügen und die Datei beim Speichern beschädigen können.

INI sicher bearbeiten: die Regeln

Das Bearbeiten selbst ist unkompliziert, solange Sie ein paar Grundregeln beachten. Sie verhindern damit, dass das Programm die Datei später nicht mehr einlesen kann:

  • Nur Werte ändern: Bearbeiten Sie in der Regel nur den Teil rechts vom Gleichheitszeichen. Schlüsselnamen links davon erwartet das Programm exakt so, wie sie sind.
  • Sektionsköpfe in Ruhe lassen: Die Zeilen in eckigen Klammern wie [anzeige] bestimmen, zu welchem Bereich ein Wert gehört. Ein Tippfehler hier ordnet Werte falsch zu.
  • Keine Werte erfinden: Fügen Sie nur Schlüssel hinzu, die das Programm auch kennt. Unbekannte Schlüssel werden ignoriert oder lösen Fehler aus.
  • Auf das Format der Werte achten: true, false und Zahlen ohne Anführungszeichen, Pfade meist ohne, Texte je nach Programm mit oder ohne Anführungszeichen.
  • Vor dem Speichern eine Kopie: Sichern Sie die Originaldatei, etwa als config.ini.bak, damit Sie im Zweifel zurückkönnen.

Kommentare sind Ihr Freund. Wenn Sie eine Zeile testweise deaktivieren möchten, löschen Sie sie nicht, sondern setzen Sie ein Semikolon davor. Das Programm überspringt die Zeile, der ursprüngliche Wert bleibt aber sichtbar:

[anzeige]
; vollbild=true
vollbild=false

Endung und Encoding: UTF-8 und kein .txt

Zwei technische Details entscheiden darüber, ob Ihre bearbeitete INI-Datei sauber funktioniert: die Dateiendung und der Zeichensatz.

Die Endung darf nicht heimlich .txt werden

Der Windows-Editor hängt beim Speichern gern ein .txt an, sodass aus config.ini unbemerkt config.ini.txt wird. Das Programm findet seine Konfiguration dann nicht mehr. So vermeiden Sie das: Wählen Sie im Speichern-Dialog beim Dateityp Alle Dateien und tippen Sie den Namen inklusive .ini vollständig selbst. Aktivieren Sie zur Kontrolle im Windows-Explorer unter Ansicht die Option Dateinamenerweiterungen, damit Sie die echte Endung immer sehen.

UTF-8 für korrekte Umlaute

Eine INI-Datei ist Text, und Text muss kodiert werden. Heute ist UTF-8 der Standard, der deutsche Umlaute ä, ö, ü und das ß zuverlässig abbildet. Speichern Sie versehentlich in ANSI (Windows-1252) und liest das Programm UTF-8, oder umgekehrt, erscheinen aus Größe plötzlich Zeichenfolgen wie Größe. Stellen Sie deshalb sowohl beim Öffnen als auch beim Speichern UTF-8 ein. Eine Feinheit: Manche Programme stolpern über UTF-8 mit BOM (einer unsichtbaren Bytefolge am Dateianfang). Bietet Ihr Editor die Wahl, nehmen Sie UTF-8 ohne BOM, wenn das einlesende Programm das BOM nicht erwartet.

Die häufigsten Fehler beim Bearbeiten

Aus der Praxis sind es immer wieder dieselben Stolperfallen, die dazu führen, dass ein Programm die INI-Datei nach dem Bearbeiten nicht mehr akzeptiert:

Fehler Auswirkung Lösung
Endung wurde .ini.txt Programm findet die Datei nicht Erweiterungen anzeigen, Endung korrigieren
Falsches Encoding Umlaute werden kryptisch Beim Speichern UTF-8 wählen
Gleichheitszeichen vergessen Zeile wird ignoriert oder Fehler Jede Zeile als schlüssel=wert prüfen
Klammer der Sektion offen Folgewerte landen falsch Eckige Klammern paarweise prüfen
Rich Text statt reiner Text Datei mit versteckten Steuerzeichen In TextEdit Reiner Text erzwingen

Die gute Nachricht: Alle diese Fehler lassen sich vor dem Speichern erkennen, wenn Sie die Datei kurz durchsehen. Noch sicherer ist ein automatischer Strukturcheck, und genau dafür eignet sich der Browser.

INI im Browser prüfen und in JSON umwandeln

Manchmal will man nach dem Bearbeiten einfach sicher sein, dass die Datei syntaktisch in Ordnung ist. Genau hier hilft unser Konverter, ganz ohne Installation. Sie fügen den INI-Text ein oder wählen die Datei lokal aus, und das Tool versucht, daraus JSON zu erzeugen. Gelingt das sauber, ist die Struktur gültig. Stolpert das Tool über eine Zeile ohne Gleichheitszeichen oder eine kaputte Sektion, nennt es Ihnen die genaue Zeilennummer.

Das ist nicht nur ein Prüfwerkzeug. Wer eine INI-Konfiguration in einem Programm weiterverwenden möchte, das lieber JSON liest, etwa in JavaScript-Projekten oder modernen Build-Werkzeugen, bekommt das passende JSON direkt mitgeliefert. Den kompletten Ablauf mit allen Optionen beschreibt der Ratgeber INI in JSON umwandeln. Wenn Sie die Datei dabei aus einer Python-Umgebung heraus verarbeiten möchten, lohnt zusätzlich der Blick in INI in JSON mit Python.

Wichtig und ein Vorteil gegenüber vielen Online-Tools: Unser Konverter arbeitet zu 100 Prozent lokal in Ihrem Browser. Die Datei wird nicht hochgeladen, sie verlässt Ihr Gerät nicht. Das ist besonders relevant, wenn Ihre INI-Datei Passwörter, Tokens oder Datenbankzugänge enthält. Warum dieser Unterschied so wichtig ist, vertieft der Ratgeber INI und JSON sicher umwandeln: Datenschutz.

INI-Datei direkt prüfen

Fügen Sie Ihren bearbeiteten INI-Text ein und sehen Sie sofort, ob die Struktur gültig ist. Lokal im Browser, ohne Upload, ohne Anmeldung.

Zum Konverter

Häufige Fragen

Womit kann ich eine INI-Datei öffnen?

Mit jedem Texteditor: unter Windows mit dem Editor (Notepad), auf dem Mac mit TextEdit im Modus Reiner Text und plattformübergreifend mit VS Code oder Notepad++. Office-Programme sind ungeeignet, weil sie Formatierungen einfügen.

Warum erscheinen meine Umlaute falsch?

Dann stimmt der Zeichensatz nicht. Speichern und öffnen Sie die Datei als UTF-8. Dann werden ä, ö, ü und ß wieder korrekt dargestellt. Vermeiden Sie UTF-8 mit BOM, wenn das Programm das nicht erwartet.

Wie verhindere ich, dass die Endung .txt wird?

Wählen Sie im Speichern-Dialog beim Dateityp Alle Dateien und tippen Sie den Namen inklusive .ini selbst. Aktivieren Sie im Explorer die Anzeige der Dateinamenerweiterungen zur Kontrolle.

Darf ich Sektionsköpfe und Schlüssel umbenennen?

In der Regel nicht. Das Programm erwartet Sektionen und Schlüssel mit exakt diesen Namen. Ändern Sie nur die Werte rechts vom Gleichheitszeichen, sofern die Programmdokumentation nichts anderes sagt.

Kann ich eine INI-Datei im Browser prüfen?

Ja. Fügen Sie den Inhalt in den INI-zu-JSON-Konverter von ini-json.de ein. Ist die Struktur gültig, entsteht sauberes JSON, andernfalls meldet das Tool die fehlerhafte Zeile. Die Datei wird nicht hochgeladen.

Weiterführende Artikel

Quellen und Methodik

Dieser Ratgeber beruht auf der gängigen Praxis im Umgang mit INI-Konfigurationsdateien unter Windows, macOS und Linux sowie auf dem dokumentierten Verhalten der genannten Editoren (Windows-Editor, TextEdit, Notepad++, VS Code) hinsichtlich Zeichensatz und Dateiendung. Die beschriebenen Schritte wurden mit aktuellen Versionen der jeweiligen Programme nachvollzogen. Stand: 25.06.2026.

Anzeige
Anzeige
Anzeige
Anzeige
Anzeige