Mods / octatonic

Tags: #Utility
Author: Sleeves
Side: Both
Created: Mar 2nd 2025 at 8:10 PM
Last modified: Apr 3rd 2025 at 5:56 PM
Downloads: 328
Follow Unfollow 7

Latest release:
octatonic-0.3.2-linux-amd64.zip


[REWRITE IN PROGRESS]

What

Mod manager via command line interface

Why

  1. Because I felt like it
  2. Because commands are quick and resource-efficient (unless I wrote them)
  3. Good programming experience
  4. Because I felt like it

Current Features

  • Search
    • Sort by downloads, recently updated, etc.
    • Ascending or descending sort
    • Filter by text, author, and/or version
  • List
    • Near useless for now (at least I'm honest)
  • Update
    • Replace outdated mods with their latest versions
  • Download
    • Accepts string names (slug / urlalias) and IDs (number)
    • Somewhat helpful error messages
  • Search-Download
    • Shows numbered results
    • Choose a number to download
    • Prompts for output directory
  • Modpack management
    • Modpacks stored in .zip files
    • Human-readable TOML definition
    • Optional mod version annotations
    • Packing, unpacking, and reading in octatonic itself

Planned Features

  • Dependency management
    • Prompt the user about dependencies when installing a mod
    • No breakage from cyclic dependency
  • Profile management
    • Usable in place of input/output for other operations
  • Configuration file
    • Checks default locations
    • Can be overriden via command option
  • Modpack overhaul
    • Optional game version annotation
    • Optional configuration bundling
  • Other additions and improvements!

Related Links

Source: https://codeberg.org/octatonic/octatonic

Mod Version Downloads Released Changelog Download
0.3.2 45 Apr 3rd 2025 at 5:55 PM octatonic-0.3.2-linux-amd64.zip

Various Improvements Part Two

 

  • Fixed incorrect filenames for mods without slugs
  • Fixed single-item authors array turning to "Various"
  • Added success logging for individual mods when installing packs
0.3.2-dev.1 33 Apr 3rd 2025 at 5:56 PM octatonic-0.3.2-win-amd64.zip

Various Improvements Part Two

 

  • Fixed incorrect filenames for mods without slugs
  • Fixed single-item authors array turning to "Various"
  • Added success logging for individual mods when installing packs
0.3.1 27 Mar 30th 2025 at 8:58 PM octatonic-0.3.1-linux-amd64.zip

Various Improvements Part One

 

**Features**
- List operation given modinfo.json parsing and table formatting
- Update operation made smarter
- Force flag added for update operation

**Fixes**
- Non-standard glyph sizes no longer break table scaling

**Syntax**
- Pack's shorthand changed from p to pp
- Unpack's shorthand changed from u to up
- Update's shorthand changed from U to u

0.3.1-dev.1 29 Mar 30th 2025 at 8:58 PM octatonic-0.3.1-win-amd64.zip

Various Improvements Part One

 

**Features**
- List operation given modinfo.json parsing and table formatting
- Update operation made smarter
- Force flag added for update operation

**Fixes**
- Non-standard glyph sizes no longer break table scaling

**Syntax**
- Pack's shorthand changed from p to pp
- Unpack's shorthand changed from u to up
- Update's shorthand changed from U to u

0.3.0 28 Mar 29th 2025 at 1:55 AM octatonic-0.3.0-linux-amd64.zip

New operation for updating any outdated mods in a folder

0.3.0-dev.1 25 Mar 29th 2025 at 1:56 AM octatonic-0.3.0-win-amd64.zip

New operation for updating any outdated mods in a folder

0.2.0 31 Mar 14th 2025 at 11:31 PM octatonic-0.2.0-linux-amd64.zip

Basic implementation of mod profiles along with improvements to stability and performance

0.2.0-dev.1 34 Mar 14th 2025 at 11:31 PM octatonic-0.2.0-win-amd64.zip

Basic implementation of mod profiles along with improvements to stability and performance

0.1.0 43 Mar 2nd 2025 at 8:15 PM octatonic-0.1.0-linux-amd64.zip

octatonic version 0.1.0 | linux amd64

First release!

0.1.0-dev.1 33 Mar 3rd 2025 at 3:15 AM octatonic-0.1.0-win-amd64.zip

octatonic version 0.1.0 | windows amd64


13 Comments (oldest first | newest first)

Sleeves , 3 days ago

Yet another rewrite underway. Details here: forum #19276

jayu, Apr 21st 2025 at 8:03 AM

I got it to compile and work fine on mac btw

jayu, Apr 19th 2025 at 12:06 PM

Sleeves (About compiling for macOS) I'll give it a try

Sleeves , Apr 3rd 2025 at 6:11 PM

Also: you may notice that modpack downloads are a little slow. This is because the process is currently synchronous, meaning only one download occurs at a time. I intend to change that in time for 0.4.0, along with the long-overdue inclusion of dependency management as requested by Hoodoo earlier in this thread.

Sleeves , Apr 3rd 2025 at 6:00 PM

MrFastZombie Thank you :-] I quite enjoyed making the thumbnail.

 

UPDATE ON MAC SUPPORT:

I still can't seem to compile for MacOS. If any mac users are willing to download the source code and compile it themselves, I would be more than happy to include it, but I myself don't have access to such a device.

MrFastZombie, Apr 1st 2025 at 2:08 AM

I like seeing the icon for this, the blob creature is cute

Sleeves , Mar 31st 2025 at 2:39 AM

jayu Having just spent over an hour trying to get octatonic to compile for MacOS, I can confidently say that Nim (the language used) is stupid. Or I'm stupid. Probably both. As such, this is now tomorrow me's problem.

jayu, Mar 31st 2025 at 12:22 AM

Does this work on mac by any chance 🥺

Sleeves , Mar 30th 2025 at 9:05 PM

I forgot to update the README version... dang it. I need to make a checklist for release chores.

Anyway, list is now useful; it reads modinfo.json files from within your zipped mods and nicely prints the data. In the distant future I'd love to have user-defined formatting for these sorts of commands, like GNU's date command. For now, the list operation prints modid, name, version, and author in that order. I decided to interpret the "authors" field (in place of "author") as "Various" rather than scale the table to include every name. Sorry about that, mod teams! Everything is also still monochrome, so if your dream is to list your mods in glorious colorvision, you're going to have to submit a PR wait a bit.

 

Enjoy! :-]

Sleeves , Mar 3rd 2025 at 10:25 PM

Hoodoo Great idea! I'm about to overhaul the error handling in the underlying library but I'll add that to the list of to-dos for the next version :-]

Hoodoo, Mar 3rd 2025 at 7:06 PM

You are my hero. Thank you so much for this mod, it's such a chore clicking through all the mods after each update, and it'll make my life so much easier! I'm just going through the list removing every line I don't remember I played with, it's so much more comfortable.

If you're looking for challenge/interesting ideas, think about adding dependency resolution (not a feature request, it's such a massive improvement to have a cli tool, but if you take it as practice it's an interesting problem).

Sleeves , Mar 3rd 2025 at 3:16 AM

I had to set up a virtual machine to do it, but the files tab now contains a windows build which Works On My Machine (tm)

Sleeves , Mar 2nd 2025 at 8:19 PM

Windows build coming as soon as I can figure out how to compile one that works :-]