From 92bda852a577a3dea5d715308e40a553cb731399 Mon Sep 17 00:00:00 2001
From: Travis Shears <t@travisshears.com>
Date: Wed, 7 Jan 2026 10:08:55 +0100
Subject: [PATCH] spec out .1line file type

---
 one_line_file_type_spec.md | 38 +++++++++++++++++++++++++++-----------
 1 file changed, 27 insertions(+), 11 deletions(-)

diff --git a/one_line_file_type_spec.md b/one_line_file_type_spec.md
index adf732d..422a850 100644
--- a/one_line_file_type_spec.md
+++ b/one_line_file_type_spec.md
@@ -4,23 +4,39 @@
 1.0.0
 
 ## Overview
-Brief description of what .1line files are for and why they exist.
+
+The .1line file format is designed to hold very low resolution pixel images. It differs from many other image formats because
+it stores the order the pixels were drawn to enable animation.
+
+At this time there is no color or alpha channel support just a pixel or no pixel for every x,y in an image.
 
 ## File Extension
 - Extension: `.1line`
 - MIME Type: `text/x-1line` (or `application/x-1line` if not plain text)
 
-## Character Encoding
-UTF-8 (or specify your encoding)
+## Encoding
 
-## Format Description
-Detailed description of the format rules.
+The file should follow the following format:
 
-## Syntax
-Formal or semi-formal syntax definition.
+```
+width (max 255)
+height (max 255)
+termination byte (255)
+```
 
-## Examples
+An example file converted from binary to text would looks something like this. Commas
+are only there to show the different numbers and would not be in the data.
+```
+88
+34
+255
+0,0,1,0,2,0,3,0,4,0,5,255
+```
 
-### Valid Examples
-```/dev/null/example.1line
-(example content)
+Or in hexadecimal:
+```
+58
+22
+FF
+0000010002000300040005FF
+```