Develop devcontainer

.devcontainer/Dockerfile

@@ -0,0 +1,14 @@
+FROM ubuntu:latest
+
+RUN apt-get update && \
+    apt-get upgrade -y && \
+    apt-get install build-essential git python3 wget cmake -y && \
+    apt-get install texinfo libc6 libgmp-dev libmpfr-dev libmpc-dev libpng-dev zlib1g-dev libtool autoconf -y && \
+    wget https://github.com/DragonMinded/libdragon/releases/download/toolchain-continuous-prerelease/gcc-toolchain-mips64-x86_64.deb && \
+    dpkg -i gcc-toolchain-mips64-x86_64.deb && \
+    rm gcc-toolchain-mips64-x86_64.deb && \
+    wget https://github.com/Polprzewodnikowy/SummerCart64/releases/download/v2.15.1/sc64-deployer-linux-v2.15.1.tar.gz && \
+    tar -xf sc64-deployer-linux-v2.15.1.tar.gz -C /usr/local/bin && \
+    rm sc64-deployer-linux-v2.15.1.tar.gz && \
+    SNIPPET="export PROMPT_COMMAND='history -a' && export HISTFILE=/commandhistory/.bash_history" && \
+    echo "$SNIPPET" >> "/root/.bashrc"

.devcontainer/devcontainer.json

@@ -0,0 +1,25 @@
+{
+    "name": "Altra64-menu",
+    "build": {
+        "dockerfile": "Dockerfile"
+    },
+    "mounts": [
+        "source=altra64-menu-bashhistory,target=/commandhistory,type=volume"
+    ],
+    "postCreateCommand": "chmod +x ./.devcontainer/postCreateCommand.sh && ./.devcontainer/postCreateCommand.sh",
+    "customizations": {
+        "vscode": {
+            "extensions": [
+                "ms-vscode.cpptools",
+                "ms-vscode.makefile-tools"
+            ],
+            "settings": {
+                "git.ignoredRepositories": [
+                    "libdragon",
+                    "lib/libyaml",
+                    "lib/libmad"
+                ]
+            }
+        }
+    }
+}

.devcontainer/postCreateCommand.sh

@@ -0,0 +1,7 @@
+# HACK to fix fatfs for our needs.
+sed -i -- 's|#define FF_USE_STRFUNC	0|#define FF_USE_STRFUNC	1|g' libdragon/src/fatfs/ffconf.h
+
+cd ./libdragon && ./build.sh
+cd .. # exit libdragon dir.
+
+cd ./lib && chmod +x ./build.sh && ./build.sh

.gitattributes

@@ -0,0 +1,4 @@
+* text=auto eol=lf
+# These are all scripts and should use crlf
+*.{cmd,[cC][mM][dD]} text eol=crlf
+*.{bat,[bB][aA][tT]} text eol=crlf

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,90 @@
+name: Bug report
+description: Create a bug report to help us improve
+labels: 
+  - "Type: Bug"
+  - "Status: Waiting triage"
+body:
+  - type: markdown
+    attributes:
+      value: |
+        # :warning: **Please read before raising the issue** :warning:
+
+        If you have a **question**, need clarification on something, need help on a particular situation or want to start a discussion, **DO NOT** open an issue here. _It will be automatically closed!_ 
+        First raise it in discussions.
+        If you really want to raise an issue, please make sure to follow the template and provide the required information.
+        Failing to do so will most likely end up on the issue being close. Don't take offense at this.
+        It is simply a time management decision.
+        Whenever an issue is raised without following the template and the required information is not provided, very often too much time has to be spent going back and forth to obtain the details that are outlined below.
+
+  - type: input
+    id: firmware_version
+    attributes:
+      label: Firmware version of the flashcart
+      description: The firmware version used
+      placeholder: V0.1
+    validations:
+      required: false
+
+  - type: input
+    id: menu_version
+    attributes:
+      label: Menu version used
+      description: The menu version used
+      placeholder: e.g 1.2.3.456, N/A
+    validations:
+      required: false
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: A clear and concise description of what the problem is.
+    validations:
+      required: true
+
+  - type: textarea
+    id: repro_steps
+    attributes:
+      label: How to reproduce
+      description: Detailed repro steps so we can see the same problem. If not already explained above.
+      placeholder: |
+        1.
+        2.
+        ...
+    validations:
+      required: false
+
+  - type: textarea
+    id: expected_behavior
+    attributes:
+      label: Expected behavior
+      description: A clear and concise description of what you expected to happen. If applicable.
+    validations:
+      required: false
+
+  - type: textarea
+    id: screenshots
+    attributes:
+      label: Screenshots
+      description: Very helpful if you send along a few screenshots to help visualize the issue!
+      placeholder: drag and drop here, if applicable
+    validations:
+      required: false
+
+  - type: textarea
+    id: other_things
+    attributes:
+      label: Additional information
+      description: Other suggested things. If applicable/relevant.
+      placeholder: |
+        for example link to the repository with sample code
+        code snippets
+    validations:
+      required: false
+
+  - type: markdown
+    attributes:
+      value: |
+        ### Make an effort to fix the bug
+
+        Attempt to submit a [Pull Request (PR)](https://help.github.com/articles/about-pull-requests/) that fixes the bug. Include in this PR a test that verifies the fix. If you were not able to fix the bug, a PR that illustrates your partial progress will suffice.

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+    - name: GitHub Discussions
+      url: https://github.com/networkfusion/altra64/discussions
+      about: Channel for asking QUESTIONS.

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,53 @@
+name: Feature request
+description: Suggest an idea to help us improve.
+labels: 
+  - "Type: Feature request"
+  - "Status: waiting feedback"
+body:
+  - type: markdown
+    attributes:
+      value: |
+        # :warning: **Please read before raising the issue** :warning:
+
+        If you have a **question**, need clarification on something, need help on a particular situation or want to start a discussion, **DO NOT** open an issue here. _It will be automatically closed!_ 
+
+        If you really want to raise an issue, please make sure to follow the template and provide the required information. Failing to do so will most likely end up on the issue being close. Don't take offense at this. It is simply a time management decision. Whenever an issue is raised without following the template and the required information is not provided, very often too much time has to be spent going back and forth to obtain the details that are outlined below.
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: Is your feature request related to a problem? Please describe.
+      placeholder: A clear and concise description of what the problem is. E.g. I'm always frustrated when [...]
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: How to solve the problem
+      description: Describe the solution you'd like
+      placeholder: A clear and concise description of what you would like to happen/exist.
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Describe alternatives you've considered
+      description: What alternatives you've considered and/or tested.
+      placeholder: A clear and concise description of any alternative solutions, features or tools that you've considered.
+    validations:
+      required: false
+
+  - type: textarea
+    id: other_context
+    attributes:
+      label: Additional context
+      description: Add any other context or screenshots about the feature request here.
+      placeholder: |
+        code snippets
+        screenshots
+        mockups
+    validations:
+      required: false

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,36 @@
+<!--- Provide a general summary of your changes in the Title above -->
+
+## Description
+<!--- Describe your changes in detail -->
+
+## Motivation and Context
+<!--- What does this PR do? What problem does it solve? -->
+<!--- If it fixes/closes/resolves an open issue, please link to the issue here  -->
+
+## How Has This Been Tested?
+<!-- (if applicable) -->
+<!--- Please describe in detail how you tested your changes. -->
+<!--- Include details of your testing environment, and the tests you ran to -->
+<!--- see how your change affects other areas of the code, etc. -->
+
+## Screenshots
+<!-- (if appropriate): -->
+
+## Types of changes
+<!--- What types of changes does your code introduce? Put an `x` in all the boxes that apply: -->
+- [ ] Improvement (non-breaking change that adds a new feature)
+- [ ] Bug fix (fixes an issue)
+- [ ] Breaking change (breaking change)
+- [ ] Config and build (change in the configuration and build system, has no impact on code or features)
+
+## Checklist:
+<!--- Go over all the following points, and put an `x` in all the boxes that apply. -->
+<!--- If you're unsure about any of these, don't hesitate to ask. We're here to help! -->
+- [ ] My code follows the code style of this project.
+- [ ] My change requires a change to the documentation.
+- [ ] I have updated the documentation accordingly.
+- [ ] I have added tests to cover my changes.
+- [ ] All new and existing tests passed.
+
+<!--- It would be nice if you could sign off your contribution by replacing the name with your GitHub user name and GitHub email contact. -->
+Signed-off-by: GITHUB_USER <GITHUB_USER_EMAIL>

.github/workflows/build.yml

@@ -0,0 +1,58 @@
+name: build
+
+on:
+  # push:
+  pull_request:
+  release:
+    types:
+      - created
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        include: [
+          { flashcart: ed64, filename: OS64.v64 },
+          { flashcart: ed64p, filename: OS64P.v64 }
+        ]
+
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          submodules: recursive
+          fetch-depth: 1 # we only require the last check-in, unless we want to create a changelog.
+
+      - name: Login to GitHub Container Registry
+        uses: docker/login-action@v2 
+        with:
+          registry: ghcr.io
+          username: ${{ github.repository_owner }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Build Altra64-Menu ROM
+        uses: devcontainers/[email protected]
+        with:
+          push: never
+          runCmd: |
+            make ${{ matrix.flashcart }}
+
+      - name: Adjust ROM name (hack)
+        if: ${{ matrix.flashcart}} == 'ed64p'
+        uses: devcontainers/[email protected]
+        with:
+          push: never
+          runCmd: |
+            mv ./bin/OS64.v64 ./bin/OS64P.v64
+            mv ./bin/OS64.elf ./bin/OS64P.elf
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v3
+        with:
+          name: Altra64-Menu-${{ matrix.flashcart}}-ROM
+          path: |
+            ./bin/*.v64
+            ./bin/*.elf
+            ./res/*.ini

.gitmodules

@@ -0,0 +1,10 @@
+[submodule "libdragon"]
+	path = libdragon
+	url = https://github.com/DragonMinded/libdragon.git
+	branch = trunk
+[submodule "lib/libyaml"]
+	path = lib/libyaml
+	url = https://github.com/yaml/libyaml
+[submodule "lib/libmad"]
+	path = lib/libmad
+	url = https://github.com/n64-tools/libmad.git

CONTRIBUTORS.md

@@ -0,0 +1,17 @@
+This menu would not have been possible without the following people:
+
+Saturnu
+Parasyte
+JonesAlmighty / NetworkFusion
+
+
+Further credit for contributions:
+Jay Oster
+Krikzz
+Richard Weick
+ChillyWilly
+Conle
+AriaHiro64
+moparisthebest
+Skawo
+Libdragon / N64Brew contributors