BranchesTags

Repository files navigation

KRaBs: Kernel Reader and Booters

KRaBs is an x86/x86_64 chain loader written in pure Rust.

What is KRaBs?

KRaBs is working on booting vmlinux and other kernels formatted in ELF on 32-bit/64-bit PCs and is under the development. Krabs also aims to support only the minimal Linux x86/x86_64 boot protocol. This allows you to use the kernel command line and initrd/initramfs.

Other features:

  • Supports GPT and FAT32 File System on EFI System Partition(ESP).
  • You can configure KRaBs's boot option in CONFIG.TXT on FAT32 ESP.
  • CONFIG.TXT is a simple matrix-oriented text file. See CONFIG.TXT formats.

News

  • 2020/08: Currently, KRaBs can boot kernel-5.8.3! initrd and kernel command line also work fine!!. see details
    cargo run -- -we disk.img

sample

Getting Started

To get started with KRaBs, build it from source.

Requirements

  1. rust-src and llvm-tools-preview
  2. GPTed disk image that has BIOS Boot Partition and EFI System Partition.
  3. CONFIG.TXT, kernel image and initrd on FAT32 FileSystem on EFI System Partition.
  4. (option) qemu-system-x86

Prepare rust-src and llvm-tools-preview

$ cd /path/to/krabs
$ rustup component add rust-src
$ rustup component add llvm-tools-preview

Example of GPT disk image:

$ gdisk -l disk.img ...
Found valid GPT with protective MBR; using GPT.
Disk disk2.img: 204800 sectors, 100.0 MiB
Sector size (logical): 512 bytes
Disk identifier (GUID): 2A1F86BB-74EA-47C5-923A-7A3BAF83B5DF
Partition table holds up to 128 entries
Main partition table begins at sector 2 and ends at sector 33
First usable sector is 34, last usable sector is 204766
Partitions will be aligned on 2048-sector boundaries
Total free space is 2014 sectors (1007.0 KiB)
Number Start (sector) End (sector) Size Code Name
1 2048 4095 1024.0 KiB EF02 BIOS boot partition
2 4096 106495 50.0 MiB EF00 EFI system partition
3 106496 204766 48.0 MiB 8300 Linux filesystem
$ sudo kpartx -av disk.img
$ sudo mkfs.fat -F 32 /dev/mapper/loop0p2
$ sudo mkfs.ext4 /dev/mapper/loop0p3

Prepare CONFIG.TXT, kernel, initrd:

$ sudo mount /dev/mapper/loop0p2 /mnt
$ ls /mnt
CONFIG.TXT initramfs.cpio.gz vmlinux-5.8.3

CONFIG.TXT format

simple matrix-oriented text file

main.kernel vmlinux-5.8.3
main.initrd initramfs.cpio.gz
main.cmdlin clocksource=tsc net.ifnames=0

Build

cargo build

Burn

cargo run -- -w disk.img

Test

cargo run -- -e disk.img

Examples

Examples for x86-64 Linux is described in the docs of 'Creating Custom Linux Images and Booting'.

Contributing

KRaBs welcomes all contributions. To contribute to KRaBs, check out the getting started guide and then the KRaBs contribution guidelines.

Design

KRaBs's overall architecture is described in the design document and the specification document.

Features

  1. Supports legacy BIOS.
  2. Supported media are HDD and SSD which have GPT.
  3. Supports 32bit protected mode and 64bit long mode.
  4. Supports OS kernel formatted in ELF32/ELF64.
  5. Supports minimal x86/x86_64 linux boot protocol.
  6. KRaBs interprets the FAT32 file system.
  7. KRaBs's boot optuon is configureset by CONFIG.TXT on the FAT32 file system.
  8. KRaBs can load modules such as initramsfs/initrd according to linux boot protocol.
  9. KRaBs can transmit kernel command line to the kernel according to linux boot protocol.

ToDO

  1. support gziped kernel.
  2. support recovery mode.

License

This project is licensed under either of

at your option.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in Serde by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Contact

You can get in touch with me in the following ways:

  • Contact me on my twitter.
  • Open a GitHub issue in this repository.
  • Email me at o8@vmm.dev.

Note: I'm on a Japan time zone.

When communicating within the Krabs community, please mind our code of conduct.

About

An x86 bootloader written in Rust.

Topics

biosbootbootloaderlinuxosdevrust

Resources

Readme

Code of conduct

Code of conduct

Contributing

Contributing
Activity

Stars

531 stars

Watchers

18 watching

Forks

20 forks
Report repository

Releases

Sponsor this project

Packages

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all 
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '

Skip to content
BranchesTags
Repository files navigation
KRaBs: Kernel Reader and Booters
KRaBs is an x86/x86_64 chain loader written in pure Rust.
What is KRaBs?
KRaBs is working on booting vmlinux and other kernels formatted in ELF on 32-bit/64-bit PCs and is under the development. Krabs also aims to support only the minimal Linux x86/x86_64 boot protocol. This allows you to use the kernel command line and initrd/initramfs.
Other features:
  • Supports GPT and FAT32 File System on EFI System Partition(ESP).
  • You can configure KRaBs's boot option in CONFIG.TXT on FAT32 ESP.
  • CONFIG.TXT is a simple matrix-oriented text file. See CONFIG.TXT formats.
News
  • 2020/08: Currently, KRaBs can boot kernel-5.8.3! initrd and kernel command line also work fine!!. see details
    cargo run -- -we disk.img

sample
Getting Started
To get started with KRaBs, build it from source.
Requirements
  1. rust-src and llvm-tools-preview
  2. GPTed disk image that has BIOS Boot Partition and EFI System Partition.
  3. CONFIG.TXT, kernel image and initrd on FAT32 FileSystem on EFI System Partition.
  4. (option) qemu-system-x86
Prepare rust-src and llvm-tools-preview
$ cd /path/to/krabs
$ rustup component add rust-src
$ rustup component add llvm-tools-preview
Example of GPT disk image:
$ gdisk -l disk.img ...
Found valid GPT with protective MBR; using GPT.
Disk disk2.img: 204800 sectors, 100.0 MiB
Sector size (logical): 512 bytes
Disk identifier (GUID): 2A1F86BB-74EA-47C5-923A-7A3BAF83B5DF
Partition table holds up to 128 entries
Main partition table begins at sector 2 and ends at sector 33
First usable sector is 34, last usable sector is 204766
Partitions will be aligned on 2048-sector boundaries
Total free space is 2014 sectors (1007.0 KiB)
Number Start (sector) End (sector) Size Code Name
1 2048 4095 1024.0 KiB EF02 BIOS boot partition
2 4096 106495 50.0 MiB EF00 EFI system partition
3 106496 204766 48.0 MiB 8300 Linux filesystem
$ sudo kpartx -av disk.img
$ sudo mkfs.fat -F 32 /dev/mapper/loop0p2
$ sudo mkfs.ext4 /dev/mapper/loop0p3
Prepare CONFIG.TXT, kernel, initrd:
$ sudo mount /dev/mapper/loop0p2 /mnt
$ ls /mnt
CONFIG.TXT initramfs.cpio.gz vmlinux-5.8.3
CONFIG.TXT format
simple matrix-oriented text file
main.kernel vmlinux-5.8.3
main.initrd initramfs.cpio.gz
main.cmdlin clocksource=tsc net.ifnames=0
Build
cargo build
Burn
cargo run -- -w disk.img
Test
cargo run -- -e disk.img
Examples
Examples for x86-64 Linux is described in
the docs of 'Creating Custom Linux Images and Booting'.
Contributing
KRaBs welcomes all contributions.
To contribute to KRaBs, check out the getting started guide
and then the KRaBs contribution guidelines.
Design
KRaBs's overall architecture is described in
the design document and
the specification document.
Features
  1. Supports legacy BIOS.
  2. Supported media are HDD and SSD which have GPT.
  3. Supports 32bit protected mode and 64bit long mode.
  4. Supports OS kernel formatted in ELF32/ELF64.
  5. Supports minimal
x86/x86_64 linux boot protocol.
  6. KRaBs interprets the FAT32 file system.
  7. KRaBs's boot optuon is configureset by CONFIG.TXT on the FAT32 file system.
  8. KRaBs can load modules such as initramsfs/initrd according to linux boot protocol.
  9. KRaBs can transmit kernel command line to the kernel according to linux boot protocol.
ToDO
  1. support gziped kernel.
  2. support recovery mode.
License
This project is licensed under either of
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in Serde by you, as defined in the Apache-2.0 license, shall be
dual licensed as above, without any additional terms or conditions.
Contact
You can get in touch with me in the following ways:
  • Contact me on my twitter.
  • Open a GitHub issue in this repository.
  • Email me at o8@vmm.dev.
Note: I'm on a Japan time zone.
When communicating within the Krabs community, please mind our
code of conduct.
About
An x86 bootloader written in Rust.
Topics
biosbootbootloaderlinuxosdevrust
Resources
Readme
Code of conduct
Code of conduct
Contributing
Contributing
Activity
Stars
531 stars
Watchers
18 watching
Forks
20 forks
Report repository
Releases
Sponsor this project
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix");
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
KRaBs: Kernel Reader and Booters
KRaBs is an x86/x86_64 chain loader written in pure Rust.
What is KRaBs?
KRaBs is working on booting vmlinux and other kernels formatted in ELF on 32-bit/64-bit PCs and is under the development. Krabs also aims to support only the minimal Linux x86/x86_64 boot protocol. This allows you to use the kernel command line and initrd/initramfs.
Other features:
  • Supports GPT and FAT32 File System on EFI System Partition(ESP).
  • You can configure KRaBs's boot option in CONFIG.TXT on FAT32 ESP.
  • CONFIG.TXT is a simple matrix-oriented text file. See CONFIG.TXT formats.
News
  • 2020/08: Currently, KRaBs can boot kernel-5.8.3! initrd and kernel command line also work fine!!. see details
    cargo run -- -we disk.img

sample
Getting Started
To get started with KRaBs, build it from source.
Requirements
  1. rust-src and llvm-tools-preview
  2. GPTed disk image that has BIOS Boot Partition and EFI System Partition.
  3. CONFIG.TXT, kernel image and initrd on FAT32 FileSystem on EFI System Partition.
  4. (option) qemu-system-x86
Prepare rust-src and llvm-tools-preview
$ cd /path/to/krabs
$ rustup component add rust-src
$ rustup component add llvm-tools-preview
Example of GPT disk image:
$ gdisk -l disk.img ...
Found valid GPT with protective MBR; using GPT.
Disk disk2.img: 204800 sectors, 100.0 MiB
Sector size (logical): 512 bytes
Disk identifier (GUID): 2A1F86BB-74EA-47C5-923A-7A3BAF83B5DF
Partition table holds up to 128 entries
Main partition table begins at sector 2 and ends at sector 33
First usable sector is 34, last usable sector is 204766
Partitions will be aligned on 2048-sector boundaries
Total free space is 2014 sectors (1007.0 KiB)
Number Start (sector) End (sector) Size Code Name
1 2048 4095 1024.0 KiB EF02 BIOS boot partition
2 4096 106495 50.0 MiB EF00 EFI system partition
3 106496 204766 48.0 MiB 8300 Linux filesystem
$ sudo kpartx -av disk.img
$ sudo mkfs.fat -F 32 /dev/mapper/loop0p2
$ sudo mkfs.ext4 /dev/mapper/loop0p3
Prepare CONFIG.TXT, kernel, initrd:
$ sudo mount /dev/mapper/loop0p2 /mnt
$ ls /mnt
CONFIG.TXT initramfs.cpio.gz vmlinux-5.8.3
CONFIG.TXT format
simple matrix-oriented text file
main.kernel vmlinux-5.8.3
main.initrd initramfs.cpio.gz
main.cmdlin clocksource=tsc net.ifnames=0
Build
cargo build
Burn
cargo run -- -w disk.img
Test
cargo run -- -e disk.img
Examples
Examples for x86-64 Linux is described in
the docs of 'Creating Custom Linux Images and Booting'.
Contributing
KRaBs welcomes all contributions.
To contribute to KRaBs, check out the getting started guide
and then the KRaBs contribution guidelines.
Design
KRaBs's overall architecture is described in
the design document and
the specification document.
Features
  1. Supports legacy BIOS.
  2. Supported media are HDD and SSD which have GPT.
  3. Supports 32bit protected mode and 64bit long mode.
  4. Supports OS kernel formatted in ELF32/ELF64.
  5. Supports minimal
x86/x86_64 linux boot protocol.
  6. KRaBs interprets the FAT32 file system.
  7. KRaBs's boot optuon is configureset by CONFIG.TXT on the FAT32 file system.
  8. KRaBs can load modules such as initramsfs/initrd according to linux boot protocol.
  9. KRaBs can transmit kernel command line to the kernel according to linux boot protocol.
ToDO
  1. support gziped kernel.
  2. support recovery mode.
License
This project is licensed under either of
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in Serde by you, as defined in the Apache-2.0 license, shall be
dual licensed as above, without any additional terms or conditions.
Contact
You can get in touch with me in the following ways:
  • Contact me on my twitter.
  • Open a GitHub issue in this repository.
  • Email me at o8@vmm.dev.
Note: I'm on a Japan time zone.
When communicating within the Krabs community, please mind our
code of conduct.
About
An x86 bootloader written in Rust.
Topics
biosbootbootloaderlinuxosdevrust
Resources
Readme
Code of conduct
Code of conduct
Contributing
Contributing
Activity
Stars
531 stars
Watchers
18 watching
Forks
20 forks
Report repository
Releases
Sponsor this project
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms");
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
KRaBs: Kernel Reader and Booters
KRaBs is an x86/x86_64 chain loader written in pure Rust.
What is KRaBs?
KRaBs is working on booting vmlinux and other kernels formatted in ELF on 32-bit/64-bit PCs and is under the development. Krabs also aims to support only the minimal Linux x86/x86_64 boot protocol. This allows you to use the kernel command line and initrd/initramfs.
Other features:
  • Supports GPT and FAT32 File System on EFI System Partition(ESP).
  • You can configure KRaBs's boot option in CONFIG.TXT on FAT32 ESP.
  • CONFIG.TXT is a simple matrix-oriented text file. See CONFIG.TXT formats.
News
  • 2020/08: Currently, KRaBs can boot kernel-5.8.3! initrd and kernel command line also work fine!!. see details
    cargo run -- -we disk.img

sample
Getting Started
To get started with KRaBs, build it from source.
Requirements
  1. rust-src and llvm-tools-preview
  2. GPTed disk image that has BIOS Boot Partition and EFI System Partition.
  3. CONFIG.TXT, kernel image and initrd on FAT32 FileSystem on EFI System Partition.
  4. (option) qemu-system-x86
Prepare rust-src and llvm-tools-preview
$ cd /path/to/krabs
$ rustup component add rust-src
$ rustup component add llvm-tools-preview
Example of GPT disk image:
$ gdisk -l disk.img ...
Found valid GPT with protective MBR; using GPT.
Disk disk2.img: 204800 sectors, 100.0 MiB
Sector size (logical): 512 bytes
Disk identifier (GUID): 2A1F86BB-74EA-47C5-923A-7A3BAF83B5DF
Partition table holds up to 128 entries
Main partition table begins at sector 2 and ends at sector 33
First usable sector is 34, last usable sector is 204766
Partitions will be aligned on 2048-sector boundaries
Total free space is 2014 sectors (1007.0 KiB)
Number Start (sector) End (sector) Size Code Name
1 2048 4095 1024.0 KiB EF02 BIOS boot partition
2 4096 106495 50.0 MiB EF00 EFI system partition
3 106496 204766 48.0 MiB 8300 Linux filesystem
$ sudo kpartx -av disk.img
$ sudo mkfs.fat -F 32 /dev/mapper/loop0p2
$ sudo mkfs.ext4 /dev/mapper/loop0p3
Prepare CONFIG.TXT, kernel, initrd:
$ sudo mount /dev/mapper/loop0p2 /mnt
$ ls /mnt
CONFIG.TXT initramfs.cpio.gz vmlinux-5.8.3
CONFIG.TXT format
simple matrix-oriented text file
main.kernel vmlinux-5.8.3
main.initrd initramfs.cpio.gz
main.cmdlin clocksource=tsc net.ifnames=0
Build
cargo build
Burn
cargo run -- -w disk.img
Test
cargo run -- -e disk.img
Examples
Examples for x86-64 Linux is described in
the docs of 'Creating Custom Linux Images and Booting'.
Contributing
KRaBs welcomes all contributions.
To contribute to KRaBs, check out the getting started guide
and then the KRaBs contribution guidelines.
Design
KRaBs's overall architecture is described in
the design document and
the specification document.
Features
  1. Supports legacy BIOS.
  2. Supported media are HDD and SSD which have GPT.
  3. Supports 32bit protected mode and 64bit long mode.
  4. Supports OS kernel formatted in ELF32/ELF64.
  5. Supports minimal
x86/x86_64 linux boot protocol.
  6. KRaBs interprets the FAT32 file system.
  7. KRaBs's boot optuon is configureset by CONFIG.TXT on the FAT32 file system.
  8. KRaBs can load modules such as initramsfs/initrd according to linux boot protocol.
  9. KRaBs can transmit kernel command line to the kernel according to linux boot protocol.
ToDO
  1. support gziped kernel.
  2. support recovery mode.
License
This project is licensed under either of
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in Serde by you, as defined in the Apache-2.0 license, shall be
dual licensed as above, without any additional terms or conditions.
Contact
You can get in touch with me in the following ways:
  • Contact me on my twitter.
  • Open a GitHub issue in this repository.
  • Email me at o8@vmm.dev.
Note: I'm on a Japan time zone.
When communicating within the Krabs community, please mind our
code of conduct.
About
An x86 bootloader written in Rust.
Topics
biosbootbootloaderlinuxosdevrust
Resources
Readme
Code of conduct
Code of conduct
Contributing
Contributing
Activity
Stars
531 stars
Watchers
18 watching
Forks
20 forks
Report repository
Releases
Sponsor this project
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links");
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '

Skip to content
BranchesTags
Repository files navigation
KRaBs: Kernel Reader and Booters
KRaBs is an x86/x86_64 chain loader written in pure Rust.
What is KRaBs?
KRaBs is working on booting vmlinux and other kernels formatted in ELF on 32-bit/64-bit PCs and is under the development. Krabs also aims to support only the minimal Linux x86/x86_64 boot protocol. This allows you to use the kernel command line and initrd/initramfs.
Other features:
  • Supports GPT and FAT32 File System on EFI System Partition(ESP).
  • You can configure KRaBs's boot option in CONFIG.TXT on FAT32 ESP.
  • CONFIG.TXT is a simple matrix-oriented text file. See CONFIG.TXT formats.
News
  • 2020/08: Currently, KRaBs can boot kernel-5.8.3! initrd and kernel command line also work fine!!. see details
    cargo run -- -we disk.img

sample
Getting Started
To get started with KRaBs, build it from source.
Requirements
  1. rust-src and llvm-tools-preview
  2. GPTed disk image that has BIOS Boot Partition and EFI System Partition.
  3. CONFIG.TXT, kernel image and initrd on FAT32 FileSystem on EFI System Partition.
  4. (option) qemu-system-x86
Prepare rust-src and llvm-tools-preview
$ cd /path/to/krabs
$ rustup component add rust-src
$ rustup component add llvm-tools-preview
Example of GPT disk image:
$ gdisk -l disk.img ...
Found valid GPT with protective MBR; using GPT.
Disk disk2.img: 204800 sectors, 100.0 MiB
Sector size (logical): 512 bytes
Disk identifier (GUID): 2A1F86BB-74EA-47C5-923A-7A3BAF83B5DF
Partition table holds up to 128 entries
Main partition table begins at sector 2 and ends at sector 33
First usable sector is 34, last usable sector is 204766
Partitions will be aligned on 2048-sector boundaries
Total free space is 2014 sectors (1007.0 KiB)
Number Start (sector) End (sector) Size Code Name
1 2048 4095 1024.0 KiB EF02 BIOS boot partition
2 4096 106495 50.0 MiB EF00 EFI system partition
3 106496 204766 48.0 MiB 8300 Linux filesystem
$ sudo kpartx -av disk.img
$ sudo mkfs.fat -F 32 /dev/mapper/loop0p2
$ sudo mkfs.ext4 /dev/mapper/loop0p3
Prepare CONFIG.TXT, kernel, initrd:
$ sudo mount /dev/mapper/loop0p2 /mnt
$ ls /mnt
CONFIG.TXT initramfs.cpio.gz vmlinux-5.8.3
CONFIG.TXT format
simple matrix-oriented text file
main.kernel vmlinux-5.8.3
main.initrd initramfs.cpio.gz
main.cmdlin clocksource=tsc net.ifnames=0
Build
cargo build
Burn
cargo run -- -w disk.img
Test
cargo run -- -e disk.img
Examples
Examples for x86-64 Linux is described in
the docs of 'Creating Custom Linux Images and Booting'.
Contributing
KRaBs welcomes all contributions.
To contribute to KRaBs, check out the getting started guide
and then the KRaBs contribution guidelines.
Design
KRaBs's overall architecture is described in
the design document and
the specification document.
Features
  1. Supports legacy BIOS.
  2. Supported media are HDD and SSD which have GPT.
  3. Supports 32bit protected mode and 64bit long mode.
  4. Supports OS kernel formatted in ELF32/ELF64.
  5. Supports minimal
x86/x86_64 linux boot protocol.
  6. KRaBs interprets the FAT32 file system.
  7. KRaBs's boot optuon is configureset by CONFIG.TXT on the FAT32 file system.
  8. KRaBs can load modules such as initramsfs/initrd according to linux boot protocol.
  9. KRaBs can transmit kernel command line to the kernel according to linux boot protocol.
ToDO
  1. support gziped kernel.
  2. support recovery mode.
License
This project is licensed under either of
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in Serde by you, as defined in the Apache-2.0 license, shall be
dual licensed as above, without any additional terms or conditions.
Contact
You can get in touch with me in the following ways:
  • Contact me on my twitter.
  • Open a GitHub issue in this repository.
  • Email me at o8@vmm.dev.
Note: I'm on a Japan time zone.
When communicating within the Krabs community, please mind our
code of conduct.
About
An x86 bootloader written in Rust.
Topics
biosbootbootloaderlinuxosdevrust
Resources
Readme
Code of conduct
Code of conduct
Contributing
Contributing
Activity
Stars
531 stars
Watchers
18 watching
Forks
20 forks
Report repository
Releases
Sponsor this project
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default");
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
KRaBs: Kernel Reader and Booters
KRaBs is an x86/x86_64 chain loader written in pure Rust.
What is KRaBs?
KRaBs is working on booting vmlinux and other kernels formatted in ELF on 32-bit/64-bit PCs and is under the development. Krabs also aims to support only the minimal Linux x86/x86_64 boot protocol. This allows you to use the kernel command line and initrd/initramfs.
Other features:
  • Supports GPT and FAT32 File System on EFI System Partition(ESP).
  • You can configure KRaBs's boot option in CONFIG.TXT on FAT32 ESP.
  • CONFIG.TXT is a simple matrix-oriented text file. See CONFIG.TXT formats.
News
  • 2020/08: Currently, KRaBs can boot kernel-5.8.3! initrd and kernel command line also work fine!!. see details
    cargo run -- -we disk.img

sample
Getting Started
To get started with KRaBs, build it from source.
Requirements
  1. rust-src and llvm-tools-preview
  2. GPTed disk image that has BIOS Boot Partition and EFI System Partition.
  3. CONFIG.TXT, kernel image and initrd on FAT32 FileSystem on EFI System Partition.
  4. (option) qemu-system-x86
Prepare rust-src and llvm-tools-preview
$ cd /path/to/krabs
$ rustup component add rust-src
$ rustup component add llvm-tools-preview
Example of GPT disk image:
$ gdisk -l disk.img ...
Found valid GPT with protective MBR; using GPT.
Disk disk2.img: 204800 sectors, 100.0 MiB
Sector size (logical): 512 bytes
Disk identifier (GUID): 2A1F86BB-74EA-47C5-923A-7A3BAF83B5DF
Partition table holds up to 128 entries
Main partition table begins at sector 2 and ends at sector 33
First usable sector is 34, last usable sector is 204766
Partitions will be aligned on 2048-sector boundaries
Total free space is 2014 sectors (1007.0 KiB)
Number Start (sector) End (sector) Size Code Name
1 2048 4095 1024.0 KiB EF02 BIOS boot partition
2 4096 106495 50.0 MiB EF00 EFI system partition
3 106496 204766 48.0 MiB 8300 Linux filesystem
$ sudo kpartx -av disk.img
$ sudo mkfs.fat -F 32 /dev/mapper/loop0p2
$ sudo mkfs.ext4 /dev/mapper/loop0p3
Prepare CONFIG.TXT, kernel, initrd:
$ sudo mount /dev/mapper/loop0p2 /mnt
$ ls /mnt
CONFIG.TXT initramfs.cpio.gz vmlinux-5.8.3
CONFIG.TXT format
simple matrix-oriented text file
main.kernel vmlinux-5.8.3
main.initrd initramfs.cpio.gz
main.cmdlin clocksource=tsc net.ifnames=0
Build
cargo build
Burn
cargo run -- -w disk.img
Test
cargo run -- -e disk.img
Examples
Examples for x86-64 Linux is described in
the docs of 'Creating Custom Linux Images and Booting'.
Contributing
KRaBs welcomes all contributions.
To contribute to KRaBs, check out the getting started guide
and then the KRaBs contribution guidelines.
Design
KRaBs's overall architecture is described in
the design document and
the specification document.
Features
  1. Supports legacy BIOS.
  2. Supported media are HDD and SSD which have GPT.
  3. Supports 32bit protected mode and 64bit long mode.
  4. Supports OS kernel formatted in ELF32/ELF64.
  5. Supports minimal
x86/x86_64 linux boot protocol.
  6. KRaBs interprets the FAT32 file system.
  7. KRaBs's boot optuon is configureset by CONFIG.TXT on the FAT32 file system.
  8. KRaBs can load modules such as initramsfs/initrd according to linux boot protocol.
  9. KRaBs can transmit kernel command line to the kernel according to linux boot protocol.
ToDO
  1. support gziped kernel.
  2. support recovery mode.
License
This project is licensed under either of
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in Serde by you, as defined in the Apache-2.0 license, shall be
dual licensed as above, without any additional terms or conditions.
Contact
You can get in touch with me in the following ways:
  • Contact me on my twitter.
  • Open a GitHub issue in this repository.
  • Email me at o8@vmm.dev.
Note: I'm on a Japan time zone.
When communicating within the Krabs community, please mind our
code of conduct.
About
An x86 bootloader written in Rust.
Topics
biosbootbootloaderlinuxosdevrust
Resources
Readme
Code of conduct
Code of conduct
Contributing
Contributing
Activity
Stars
531 stars
Watchers
18 watching
Forks
20 forks
Report repository
Releases
Sponsor this project
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers");
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
KRaBs: Kernel Reader and Booters
KRaBs is an x86/x86_64 chain loader written in pure Rust.
What is KRaBs?
KRaBs is working on booting vmlinux and other kernels formatted in ELF on 32-bit/64-bit PCs and is under the development. Krabs also aims to support only the minimal Linux x86/x86_64 boot protocol. This allows you to use the kernel command line and initrd/initramfs.
Other features:
  • Supports GPT and FAT32 File System on EFI System Partition(ESP).
  • You can configure KRaBs's boot option in CONFIG.TXT on FAT32 ESP.
  • CONFIG.TXT is a simple matrix-oriented text file. See CONFIG.TXT formats.
News
  • 2020/08: Currently, KRaBs can boot kernel-5.8.3! initrd and kernel command line also work fine!!. see details
    cargo run -- -we disk.img

sample
Getting Started
To get started with KRaBs, build it from source.
Requirements
  1. rust-src and llvm-tools-preview
  2. GPTed disk image that has BIOS Boot Partition and EFI System Partition.
  3. CONFIG.TXT, kernel image and initrd on FAT32 FileSystem on EFI System Partition.
  4. (option) qemu-system-x86
Prepare rust-src and llvm-tools-preview
$ cd /path/to/krabs
$ rustup component add rust-src
$ rustup component add llvm-tools-preview
Example of GPT disk image:
$ gdisk -l disk.img ...
Found valid GPT with protective MBR; using GPT.
Disk disk2.img: 204800 sectors, 100.0 MiB
Sector size (logical): 512 bytes
Disk identifier (GUID): 2A1F86BB-74EA-47C5-923A-7A3BAF83B5DF
Partition table holds up to 128 entries
Main partition table begins at sector 2 and ends at sector 33
First usable sector is 34, last usable sector is 204766
Partitions will be aligned on 2048-sector boundaries
Total free space is 2014 sectors (1007.0 KiB)
Number Start (sector) End (sector) Size Code Name
1 2048 4095 1024.0 KiB EF02 BIOS boot partition
2 4096 106495 50.0 MiB EF00 EFI system partition
3 106496 204766 48.0 MiB 8300 Linux filesystem
$ sudo kpartx -av disk.img
$ sudo mkfs.fat -F 32 /dev/mapper/loop0p2
$ sudo mkfs.ext4 /dev/mapper/loop0p3
Prepare CONFIG.TXT, kernel, initrd:
$ sudo mount /dev/mapper/loop0p2 /mnt
$ ls /mnt
CONFIG.TXT initramfs.cpio.gz vmlinux-5.8.3
CONFIG.TXT format
simple matrix-oriented text file
main.kernel vmlinux-5.8.3
main.initrd initramfs.cpio.gz
main.cmdlin clocksource=tsc net.ifnames=0
Build
cargo build
Burn
cargo run -- -w disk.img
Test
cargo run -- -e disk.img
Examples
Examples for x86-64 Linux is described in
the docs of 'Creating Custom Linux Images and Booting'.
Contributing
KRaBs welcomes all contributions.
To contribute to KRaBs, check out the getting started guide
and then the KRaBs contribution guidelines.
Design
KRaBs's overall architecture is described in
the design document and
the specification document.
Features
  1. Supports legacy BIOS.
  2. Supported media are HDD and SSD which have GPT.
  3. Supports 32bit protected mode and 64bit long mode.
  4. Supports OS kernel formatted in ELF32/ELF64.
  5. Supports minimal
x86/x86_64 linux boot protocol.
  6. KRaBs interprets the FAT32 file system.
  7. KRaBs's boot optuon is configureset by CONFIG.TXT on the FAT32 file system.
  8. KRaBs can load modules such as initramsfs/initrd according to linux boot protocol.
  9. KRaBs can transmit kernel command line to the kernel according to linux boot protocol.
ToDO
  1. support gziped kernel.
  2. support recovery mode.
License
This project is licensed under either of
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in Serde by you, as defined in the Apache-2.0 license, shall be
dual licensed as above, without any additional terms or conditions.
Contact
You can get in touch with me in the following ways:
  • Contact me on my twitter.
  • Open a GitHub issue in this repository.
  • Email me at o8@vmm.dev.
Note: I'm on a Japan time zone.
When communicating within the Krabs community, please mind our
code of conduct.
About
An x86 bootloader written in Rust.
Topics
biosbootbootloaderlinuxosdevrust
Resources
Readme
Code of conduct
Code of conduct
Contributing
Contributing
Activity
Stars
531 stars
Watchers
18 watching
Forks
20 forks
Report repository
Releases
Sponsor this project
Packages
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode");
}
} catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); }
})();
})();

Skip to content
BranchesTags
Repository files navigation
KRaBs: Kernel Reader and Booters
KRaBs is an x86/x86_64 chain loader written in pure Rust.
What is KRaBs?
KRaBs is working on booting vmlinux and other kernels formatted in ELF on 32-bit/64-bit PCs and is under the development. Krabs also aims to support only the minimal Linux x86/x86_64 boot protocol. This allows you to use the kernel command line and initrd/initramfs.
Other features:
  • Supports GPT and FAT32 File System on EFI System Partition(ESP).
  • You can configure KRaBs's boot option in CONFIG.TXT on FAT32 ESP.
  • CONFIG.TXT is a simple matrix-oriented text file. See CONFIG.TXT formats.
News
  • 2020/08: Currently, KRaBs can boot kernel-5.8.3! initrd and kernel command line also work fine!!. see details
    cargo run -- -we disk.img

sample
Getting Started
To get started with KRaBs, build it from source.
Requirements
  1. rust-src and llvm-tools-preview
  2. GPTed disk image that has BIOS Boot Partition and EFI System Partition.
  3. CONFIG.TXT, kernel image and initrd on FAT32 FileSystem on EFI System Partition.
  4. (option) qemu-system-x86
Prepare rust-src and llvm-tools-preview
$ cd /path/to/krabs
$ rustup component add rust-src
$ rustup component add llvm-tools-preview
Example of GPT disk image:
$ gdisk -l disk.img ...
Found valid GPT with protective MBR; using GPT.
Disk disk2.img: 204800 sectors, 100.0 MiB
Sector size (logical): 512 bytes
Disk identifier (GUID): 2A1F86BB-74EA-47C5-923A-7A3BAF83B5DF
Partition table holds up to 128 entries
Main partition table begins at sector 2 and ends at sector 33
First usable sector is 34, last usable sector is 204766
Partitions will be aligned on 2048-sector boundaries
Total free space is 2014 sectors (1007.0 KiB)
Number Start (sector) End (sector) Size Code Name
1 2048 4095 1024.0 KiB EF02 BIOS boot partition
2 4096 106495 50.0 MiB EF00 EFI system partition
3 106496 204766 48.0 MiB 8300 Linux filesystem
$ sudo kpartx -av disk.img
$ sudo mkfs.fat -F 32 /dev/mapper/loop0p2
$ sudo mkfs.ext4 /dev/mapper/loop0p3
Prepare CONFIG.TXT, kernel, initrd:
$ sudo mount /dev/mapper/loop0p2 /mnt
$ ls /mnt
CONFIG.TXT initramfs.cpio.gz vmlinux-5.8.3
CONFIG.TXT format
simple matrix-oriented text file
main.kernel vmlinux-5.8.3
main.initrd initramfs.cpio.gz
main.cmdlin clocksource=tsc net.ifnames=0
Build
cargo build
Burn
cargo run -- -w disk.img
Test
cargo run -- -e disk.img
Examples
Examples for x86-64 Linux is described in
the docs of 'Creating Custom Linux Images and Booting'.
Contributing
KRaBs welcomes all contributions.
To contribute to KRaBs, check out the getting started guide
and then the KRaBs contribution guidelines.
Design
KRaBs's overall architecture is described in
the design document and
the specification document.
Features
  1. Supports legacy BIOS.
  2. Supported media are HDD and SSD which have GPT.
  3. Supports 32bit protected mode and 64bit long mode.
  4. Supports OS kernel formatted in ELF32/ELF64.
  5. Supports minimal
x86/x86_64 linux boot protocol.
  6. KRaBs interprets the FAT32 file system.
  7. KRaBs's boot optuon is configureset by CONFIG.TXT on the FAT32 file system.
  8. KRaBs can load modules such as initramsfs/initrd according to linux boot protocol.
  9. KRaBs can transmit kernel command line to the kernel according to linux boot protocol.
ToDO
  1. support gziped kernel.
  2. support recovery mode.
License
This project is licensed under either of
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in Serde by you, as defined in the Apache-2.0 license, shall be
dual licensed as above, without any additional terms or conditions.
Contact
You can get in touch with me in the following ways:
  • Contact me on my twitter.
  • Open a GitHub issue in this repository.
  • Email me at o8@vmm.dev.
Note: I'm on a Japan time zone.
When communicating within the Krabs community, please mind our
code of conduct.
About
An x86 bootloader written in Rust.
Topics
biosbootbootloaderlinuxosdevrust
Resources
Readme
Code of conduct
Code of conduct
Contributing
Contributing
Activity
Stars
531 stars
Watchers
18 watching
Forks
20 forks
Report repository
Releases
Sponsor this project
Packages
Used by
Contributors
Languages