Tantibus

[opal mirage]

Tantibus is an RPG Maker game by Ben Allen. He has given me Ready To Run permission!

A neon lit world filled with nightmare creatures and bizarre situations exists by the name of Tantibus. Journey from your very normal and totally boring home where nothing weird ever happens of Cobble's Key to whatever exists past the first boss.

Be there man eating clocks?

Be there vomiting gardeners?

Be there depressed lamps?

Be there faceless men?

Yup!

SOURCE URL: https://benal.itch.io/tantibus

Controls:
DPad = Movement
L Analog=Movement
A = Action
B = Cancel
Y/R1 = Run

CFW Tests:
[] AmberELEC
[] ArkOS
[X] ROCKNIX
[X] MuOS
[] Knulli (Optional)
[] Crossmix (Optional)

Architectures:
[X] Aarch64
[X] Panfrost (Mainline)

Resolutions:
[] 480x320
[X] 640x480
[] 720x720 (RGB30)
[X] Higher resolutions (e.g., 1280x720)

Port Files:

https://www.mediafire.com/file/1lfii3dmolixq3d/tantibus.zip/file

Port is ready to run so just install it!

[rigid pulsar]

Where's the zip

[opal mirage]

right there! 🙂

[rigid pulsar]

<@&1216123318122577972>

[agile swift]

Why not upload it to discord?

[opal mirage]

its ready to run

77MB

new zip i just changed. forgot to make the PNG named screenshot instead of cover

is there a way to do it without Nitro?

I used the generator for each metadata file this time. I'm hoping for a MUCH smoother P.R experience for this one I think if I remember right, for the Aspect, i used other ones as a template.

[opal mirage]

Thank you!

You've got nitro is that how you're able to?

[agile swift]

yeah

Quick Feedback:

• licenses go into a subfolder called licenses
• licenses for the libraries you ship in your port need to be prsent also so for stuff like libFLAC.so.8
• port.json is not correct, use the port.json generator and carefully watch what needs to go into the .sh name and zip field. Compare with other ports how it needs to look like.
• port.json grammar in instructions Field 🙂
• readme needs a link to the game not the creators page
• gameinfo.xml image points to cover.png but you only do screenshot.png, switch it to screenshot.png then
• outdated .sh source $controlfolder/device_info.txt and other stuff needs to go. Go to our packagin website to revise the script and remove unnecessary lines

where on eartht did you find such an old script lol

[opal mirage]

Tabreturn told me to use Kaima as a template

So when you make a Json it says in the text field before you enter anything "/.port.sh" also for image "/.portfolder/screenshot.png

Do we NOT add the slash at the beginning?

[opal mirage]

Everything you circled I need to remove?

[agile swift]

reread my instructions carefully

Go to our website and compare the scripts

There is even explanations as to what line does what

[opal mirage]

Do I use "basic launchscript" to compare

Cause there's no example for rpgmaker

[agile swift]

yes

[opal mirage]

And this? - #1337471989920567387 message

[agile swift]

That's just an example what is wrong

Go to the website and compare and understand

[dusky bluff]

woah, wait a minute --- let's be clear here: i told you the most recent rpgmaker game is kaima, so that is likely the best place to start. further to that, i indicated it wouldn't be perfect and pointed you to the official documentation .sh example, along with some partial changes to get you started

[dusky bluff]

see official documentation

(i think slayer might have made an incorrect comment regarding ./Game Name.sh (in the json) in your last p.r, but that was never committed if you check the aspect)

[opal mirage]

Oh i think I fixed that

[dusky bluff]

the game runs fine rg351v amberelec
however, it seems like your A/B buttons are the wrong way around (at least according to the instructions)

[opal mirage]

You've been nothing but helpful and patient in working with me to get these ganes ported. Wasn't trying to say anything bad. I could never thank you enough!

Can you check the gptk for me and see?

[dusky bluff]

i crossed that out -- the game confused me a bit here, because b raises the menu

[opal mirage]

These are the controls

Oh okay. Sorry

I'm glad I didn't make a mistake there at least

[dusky bluff]

amberelec will have the mouse cursor at the top left of the screen all the time, but we know about this issue

[opal mirage]

Going to attempt to fix scripts

so from what i can see on the luanchscript on packaging website

this also doesnt need ot be there correct?

CUR_TTY=/dev/tty0
$ESUDO chmod 666 $CUR_TTY

need to update this-exec > >(tee "$GAMEDIR/log.txt") 2>&1

to this-> "$GAMEDIR/log.txt" && exec > >(tee "$GAMEDIR/log.txt") 2>&1

not sure hwo im know what to do here

Some ports like to create save files or settings files in the user's home folder or other locations. We map these config folders so we can either preconfigure games and or have the savefiles in one place. I

You can either use XDG variables to redirect the Ports to our gamefolder if the port supports it:

thi sis what i have so far

#!/bin/bash

XDG_DATA_HOME=${XDG_DATA_HOME:-$HOME/.local/share}

if [ -d "/opt/system/Tools/PortMaster/" ]; then
controlfolder="/opt/system/Tools/PortMaster"
elif [ -d "/opt/tools/PortMaster/" ]; then
controlfolder="/opt/tools/PortMaster"
elif [ -d "$XDG_DATA_HOME/PortMaster/" ]; then
controlfolder="$XDG_DATA_HOME/PortMaster"
else
controlfolder="/roms/ports/PortMaster"
fi

source $controlfolder/control.txt

get_controls

GAMEDIR=/$directory/ports/tantibus
CONFDIR="$GAMEDIR/conf/"

mkdir -p "$GAMEDIR/conf"

"$GAMEDIR/log.txt" && exec > >(tee "$GAMEDIR/log.txt") 2>&1

cd $GAMEDIR

export XDG_CONFIG_HOME="$CONFDIR"
export XDG_DATA_HOME="$CONFDIR"

the bottom part is confusing me a little bit

[agile swift]

always post code in discord code blocks 3x `

do you see config_home anywhere in the example script?

No? Why do you still have it 🙂

[opal mirage]

i dont

i wanst sure

oay

so deleted thAT

IL KEEP THE EXPORT SDL

[agile swift]

Do your thing than post your .zip when your confident that you changed most

you have the example script and how it needs to look

even with explanations 🙂

[opal mirage]

remove the export_LD ?

ye si remove the LD

its the very bottom im confused about

it looiks nothing liek the example script

its -d and the example is -f

[agile swift]

I told you know two times

Learn what each line does

then you understand why its in there

if its too complicated use chatgpt to let it explain to you

[opal mirage]

im only aksing because in the very top of the launchscrit page it say snothign about anything for -d

but you didnt circle it so i know its supposed to be there but i dont know why

[agile swift]

all these questions will be answered if you learn what the line does

you're just comparing lines instead of understanding what the line does 🙂

https://chatgpt.com/share/67a67645-bb30-8012-822a-bcad656c5dd0

Now I'm doing it again, resaerching for you to show it you so

You could have done the same 🙂

Gotta work on solving problems before asking for help 🙂

you can even ask it to explain it to you like your'e 5 🙂

[opal mirage]

i apologize, im trying to use the launchscript page form portmaster and i just dont see anything at all about [-d gamedata/lib]

[agile swift]

You're doing it again 🙂

You have to go back 5 steps

[opal mirage]

but iw ill try using chatgpt

[agile swift]

Stop focusing on that line

you have to see the bigger pictue

understand the reason for it first

then you look at the details

I even now sent you a link where it explains every line

[opal mirage]

CHATGPT IS INCREDIBLE

Iv eonly used it a few times but wow

[agile swift]

maybe you ask your question in chatgpt first then here 🙂

[opal mirage]

The -d checks if a directory named gamedata/lib exists.

[agile swift]

So you learned something

great

you can even use our official portmaster helper chatgpt

https://chatgpt.com/g/g-ypYGgo4y8-portmaster-helper

[opal mirage]

im literally laughing to myself about how incredibly detailed it explains it

so that line just removes that folder once its launched

i get it now!

WOW

[dusky bluff]

i didn't know about this?!

it is smart, though 😜

[agile swift]

Well I'm the only one who uses it 😄

[opal mirage]

one question

export LD_LIBRARY_PATH="$GAMEDIR/libs.${DEVICE_ARCH}:$LD_LIBRARY_PATH"

what do i put in device_arch'

[agile swift]

...

Ask chatgpt come back

[opal mirage]

okay

[agile swift]

i also have one for claude

but it's not shareable I'm afraid

[opal mirage]

the naswer chatgpt gave me was expected

but you see i don tunderstand the differneces that well in computers

[agile swift]

So what was the answer?

[opal mirage]

so if these are armbased devices

aarch64?

[agile swift]

That you don't put anything in there and its there so its dynamically filled by portmaster depending what device you're using

[opal mirage]

or is that wrong

OH

i was thinking i needed to fill it out

sorry i was confused

can you check for me?

[agile swift]

Nope, finish first and then I'll check 🙂

[opal mirage]

i think im finished..

is that not right?

[agile swift]

now test if your game still works 🙂

[opal mirage]

missing {device arch}s at the bottom?

$GPTOKEYB "portexecutable.${DEVICE_ARCH}" -c "./portname.gptk.$ANALOGSTICKS" &
pm_platform_helper "$GAMEDIR/portexecutable.${DEVICE_ARCH}"
./portexecutable.${DEVICE_ARCH}

that needs to be added right?

i also see after gptk.$ANALOGSTICKS" which isnt in mine so i need to add that?

[agile swift]

What did I tell you about codeblocks?

3x `at begining and end

[opal mirage]

ooooh

you actually type xxx?

[agile swift]

yes 
you 
do

[opal mirage]

OH '''

[agile swift]

`

[opal mirage]

'''code block

[agile swift]

three times `

`

not "

three times `
at beginning and three times at the end

[opal mirage]

OKAY

then how do you send it?

ohj oay

[agile swift]

enter lol

[opal mirage]

at the end too

code 
blocks
are
easy

[agile swift]

there you go

[opal mirage]

tyvm

you knew it wouldnt launch -.-

[agile swift]

Check via ssh where it complains 🙂

[opal mirage]

it ran fine with the old script so something needs to be changed i guess

Do it needs a new lib now?

[agile swift]

...

What did I just tell you

Check via ssh and see where it complains

If you don't know what that means ask chatgpt

And if the next question then is how do I do that you ask gpt that also 🙂

[opal mirage]

Ok man.

[agile swift]

try also renaming your folder to libs.aarch64 🙂

[opal mirage]

Having it run before and now not with this new script is a little disheartening. Ngl.
I've never used ssh before or what it is but I'll try to figure it out.

Okay

Currently in the bathroom

👍 👍 👍

[agile swift]

Important skill in porting 🙂

[agile swift]

also on our websiste

https://portmaster.games/faq.html#how-can-i-run-my-port-via-ssh-to-troubleshoot-any-starting-issue

[opal mirage]

Ohhh wow putty I've never heard of

I'll dowbload it

This used the network, good

Cause my laptop will not recognize my device for gadget function no matter what I do

That site still says JELOS. you might wanna uodate it to rocknix and it's root/rocknix

[opal mirage]

i renamed the folder to libs.aarch64

but it still says this

putty i cant get working

im at a standstill

my god damn x55 keeps fucking up

OMG

anyways @agile swift do i need to add a different version of libsigc-2.0.so.0?

[agile swift]

If it worked before why would you need a different version?

[opal mirage]

i added the $ in front of Pm_platformhelper

and htat fixed that part

but i dont understand what this means or how to fix it

[agile swift]

post current your zip

this means it can't find the library

[opal mirage]

the .sh or the whole thing

i havent fixed json and stuff yet

[agile swift]

do that then 🙂

[opal mirage]

ok

my x55 is still all f**ked up

whats wreong with my grammar in json instructions?

i dont see what youre talking about

copied directly from the json

"download the game for free here:\nhttps://benal.itch.io/tantibus\nextract and add all game files to the gamedata folder.",

[agile swift]

First letter is lower case lol

https://tenor.com/view/that-was-mean-as-hell-saturday-night-live-that-was-super-mean-rude-comment-uncalled-for-gif-23826410

[opal mirage]

where do i get the license for libflac.8.so?

[opal mirage]

haha okay okay i see

in another port i can use to grab it?

[agile swift]

https://github.com/xiph/flac/blob/master/COPYING.GPL

[opal mirage]

hey thank you!

and put that also in the license subfolder?

[agile swift]

You have the answers already

[opal mirage]

gotcha

okay

heres the "broken" zip but everything fixed you asked for

[agile swift]

Where?

[opal mirage]

https://www.mediafire.com/file/8snl8inmay8puao/Tantibus.zip/file

there 🙂

[agile swift]

• When zipping please zip it so that you only get tantibus and Tantibus.sh in the .sh else you can't install the testing zip via portmaster directly
• You are missing stuff in the .sh, i said whats wrong in the .sh yes but it was also missing stuff from the example script

For example

# We source custom mod files from the portmaster folder example mod_jelos.txt which containts pipewire fixes
[ -f "${controlfolder}/mod_${CFW_NAME}.txt" ] && source "${controlfolder}/mod_${CFW_NAME}.txt"```

where is this

[opal mirage]

ok

sorry

k that has been added right before get_controls

[agile swift]

nvm, good 🙂

[opal mirage]

i was like... am i fucking blind?

it runs now!

wooooooo

k heres the FINAL ZIP

gimee a sec

so how do i zip it up correctly?

with all the metadata in the first folder too including the.sh?

oh i think i get it

well maybe not acually

i have a folder on my desktop named Tantibus. inside is tantibus and Tantibus.sh

[agile swift]

when i open the zip i want to see this

[opal mirage]

so how do i zip up those 2 things together wihtout being in a folder?

[agile swift]

mind this is just for the testing zip 🙂

mark both -> right click send to archive lol

[opal mirage]

ok

i think i got it

here we go. is this right?

https://www.mediafire.com/file/1lfii3dmolixq3d/tantibus.zip/file

[agile swift]

lol

[opal mirage]

You and @dusky bluff are such amazing people. thank you for assisting me

dafuq

how

all i did was highlight the 2 and compress to zip

that happened to me with one of jans ports

i had to download it on my phone and transfer it over an d hurry and unzip it

flinthook i think it was

so what do i do about that?

[agile swift]

ts ts ts

😄

[opal mirage]

[dusky bluff]

give a man a fishport template, and you feed him for a day you get one port. teach a man to fishport, and you feed him have ports for a lifetime

[opal mirage]

youve both taught me more than i knew 10 days ago thats for sure

lets hope it sticks 😛

[dusky bluff]

this guy says it better 🤣
https://www.youtube.com/watch?v=ncRi8bZL1q4

[opal mirage]

but seriously... what do i do? if its tellign people theres a virus thats not gonna be good

[agile swift]

nothing, delete the link and go towards your pr 🙂

[opal mirage]

rofl everyone starts laughing at him in the background hilarious

just pr it?

[dusky bluff]

what if it has viruses?

[opal mirage]

lol

it doesnt

[agile swift]

We'll upload it to virus-total

[opal mirage]

it wont let me drag it in

it says YOWZA thats a lot of files

[agile swift]

240 files

[opal mirage]

yeah it says try uplaoding 100 or less

[dusky bluff]

i think you've out-grown the github web interface

[agile swift]

https://tenor.com/view/im-out-we-out-peace-out-disappear-gif-15464202

[opal mirage]

but the desktop is like 30gigs right?

[dusky bluff]

more like 50gb, i think, haha

[opal mirage]

yeah that sucks

i mean i have 290 free

[agile swift]

https://tenor.com/view/bye-slide-baby-later-peace-out-gif-19322436

[opal mirage]

but still... so i gotta use desktop git?

[dusky bluff]

well, some form of client-side git

but it'll be the same issue in every instance

[opal mirage]

well ive prd all mine with web based so tell me what to do

[opal mirage]

youre saying it will still limit me to 100 using the desktop?

[dusky bluff]

you could zip the game files, then have the .sh unzip them

[opal mirage]

ok.

that i will need some help with

[dusky bluff]

but, long-term, if you're gonna do a bunch of ports, you must as well jump into github-desktop, etc.

[opal mirage]

ill download desktop right now

but will it still limit me to 100 files?

[dusky bluff]

maybe, but i don't think so

you could just do multiple uploads?

[opal mirage]

h...

hm...

[dusky bluff]

so, no more than 100 at a time

[opal mirage]

so id just do liek the first 2 folders of gamedata?

or maybe each one

as long as i grab them from the same folder on my desktop, theyll go where they need to?

[dusky bluff]

yeah, something like that

[opal mirage]

lemee try it

it seems liek when i go into tantibus/gamedata/audio and drag the audio file over, it is only seeing it as /audio/all other files

not as tantibus/gamedata/audio

[dusky bluff]

so, navigate into tantibus/gamedata/audio first?

[opal mirage]

i did

[dusky bluff]

i don't understand, sorry

[dusky bluff]

why are you in the aspect folder?

[opal mirage]

its not registering as in tantibus/gamedata

oh shit i bookmarked it

thats my fault

[agile swift]

lol

[opal mirage]

so i need to create a new branch?

[dusky bluff]

that's how cool people do it, but it's not entirely necessary. but it's better to be cool

[opal mirage]

my default branch is The-Aspect

[dusky bluff]

make a new branch

[opal mirage]

i did

it says your branches and active branches

both tantibus

[dusky bluff]

https://github.com/NotYourAveragePaladin/PortMaster-New/tree/Tantibus/ports

that should go to the correct branch, where you can upload, etc.

[opal mirage]

but i wanna understand what i did wrong

[dusky bluff]

you didn't switch branches, or something

[opal mirage]

okay, well i guess i will just use this link for now but i wanna know what i need to do for each port cause i have 6 more

not today but wokring on

oh i see

[dusky bluff]

ONE PORT AT A TIME

(for now)

[opal mirage]

i clicked on active branch /tantibus then clicked ports and it went to the page you sent

[opal mirage]

i know i know.

so now add file

[opal mirage]

but it stsill goign to do the same thing

like in the oi ci showed you

yeah so once tiny town defense was put into the main repository, its gone after that right?

that branch

thats what cofnused me is i starte dthe aspect after tiny town was commite

branches are different ports youre working on at one time before the website updates

[dusky bluff]

you need to read/watch a github tutorial

[agile swift]

I think i told him that 4 times

lol

[dusky bluff]

way more efficient than trying to explain these concepts in a discord

[opal mirage]

i tried to. it was very... confusing. lots of terms i dont really know the meaning of

[opal mirage]

but is that correct?

[dusky bluff]

it depends ...

[opal mirage]

hm... oh

[agile swift]

https://youtu.be/Oaj3RBIoGFc

[opal mirage]

cebion, does this look right or is this not going to work? adding folders one at a time

shouldnt the libs files say tanitbus/libs not just /libs

[agile swift]

I don't know

I never do this via browser

[opal mirage]

wel what tab suggested

is that i open the gamedata folder and drop each folder in seperately

[agile swift]

You have to stop relying on every single word and just do it, try stuff

[dusky bluff]

you are literally our resident github browser expert -- nobody else does this stuff via the web interface

[opal mirage]

okay ill just uplaod iot and see if it works

[agile swift]

and watch the video

And make atest repository and play around with it

and then you come back

[opal mirage]

ya it wont work

i removed the gamedata folder to my desktop and uploaded them

you can see the difference im tlaking about

it doesnt recognize the previous folder

in the pic above. in this one it does

so how can i zip the gamedata folder and hvae the ,sh unzip it

is there a page on the portmaster site that shows me what to do?

[agile swift]

What are you doing?

Go watch the video?!!?

😄

The video is there to tell you what to do

That was no joke man

[opal mirage]

tab said i could just zip the file and have the ,sh unzip it for me

i will watch it

but if i can just have the sh unzip it why not do that?

[dusky bluff]

don't do this

[opal mirage]

well i thought you told me to do that

[dusky bluff]

there are better solutions

[opal mirage]

like downloading desktop?

the folder has 240 files so

[dusky bluff]

i'm pretty sure it's do-able via the web interface. but, yes, you could use github desktop to do 100 file at a time

[opal mirage]

im trying to do 240 files at a time

[dusky bluff]

watch the video (and you'll understand you can do as many/few files you like at once)

[opal mirage]

becaus if i go into the gamedata folder and drag folder over individually, github doesnt recognize what previous folder path it was from

[agile swift]

Go watch the video

[opal mirage]

ok

[agile swift]

I'll lock the thread, i swear

😄

[opal mirage]

hes so right bout "it can be depressing"

[agile swift]

That was no joke what I wrote,I meant it lol

[opal mirage]

okay

so when using github desktop, i am cloning this url right?

https://github.com/NotYourAveragePaladin/PortMaster-New

its slowly progressing

30%

[half smelt]

You are using Tantibus branch inside your forked repo, right?

[opal mirage]

im downloading github desktop right now

well clonming the portaster-new repository

its taking a very long time

[opal mirage]

i was though yes, but i cant upload more than 100 files on the web

[opal mirage]

so i think i might hav emessed up

this is my guthub desktip

it shows the aspect..

Okay I found branches at the top

And opened tantibus

It says preview or open pull request

And yes I watched the video. It's hard to to use what he says though because his demo is based on private repositories for personal projects.

But I will fiddlefuck around with this and see what I can do

i cnat figure out how to add files to this. its all so confusing to me. you guys have been so helpful to me getting this port all ready i feel terrible even posting on this thread anymore

i want to just get this prd all by myself

so when im adding files, do i just add them directly to where the repository files are saved on my laptop? in the ports folder

i dont add them through anythign on the github desktop thing

in Documents/GitHub/PortMaster-New/ports? on my computer itself

pushing to origin now

[agile swift]

You can create private repositories as well 🙂

[opal mirage]

I hope I did this right ceb..

It's way different than the browser

I pushed to origin

And it's done doing that

So let me know if it's there and correct

I had forgotten the gamedata folder the first time cause I moved it out which was 21 files, then added it back, being 219. So 240 🙂

[opal mirage]

Please let me know if I did this correctly

[pearl knot]

don´t work in TSP Crossmix

[agile swift]

try knulli 🙂

[opal mirage]

https://www.mediafire.com/file/1lfii3dmolixq3d/tantibus.zip/file

[opal mirage]

This the zip you downloaded?

[agile swift]

it's crossmix they're missing bunch of libs

they have to add it to their /usr/lib themselves if anyting is missing

[opal mirage]

Aaaahhh

[agile swift]

don#t bother

[opal mirage]

So I didn't realize github desktop brought the files locally to your pc

It is actually a lot nicer

Just copy what you wanna port over to that location and push to origin

[opal mirage]

I see tantibus in the forked repository in /ports.

So do I now sync fork?

[agile swift]

You always sync your fork

[opal mirage]

Well after I pushed to origin, I didn't know if that was done already through the desktop version. But I saw it on the browser

When I click sync fork, a drop down pops up with Update Branch so I just did that now

Created new pull request

[agile swift]

so

quick question

😄

Where is your main branch

Default should always be main

I hope you did not delete it lol

you now the main is the tree

and branches are branches that go from it

so you always keep your main up to date

and the branches then of course too

but when you don't have a main to branch of from

it doesn't work

[opal mirage]

Default I think I remember said was the aspect :/

[agile swift]

Nope

Why woudl a port of you be default

It does not delete itself

[agile swift]

yes, this is the status now

but its not like this by default

[opal mirage]

How do I make it

[agile swift]

You deleted it...

I don't think you can recover it

[opal mirage]

No idea how i did

[agile swift]

maybe you did this

or something

[opal mirage]

No

[agile swift]

https://tenor.com/view/dance-coffin-meme-rip-gif-16909625

https://tenor.com/view/top-gun-icemav-top-gun-maverick-top-gun-maverick-funeral-funeral-gif-26848803

[opal mirage]

I didn't

What do I need to do

[agile swift]

Well it does make it another branch default automatically

[opal mirage]

Help

[agile swift]

ask chatgpt, because that's deep kaka

[opal mirage]

This shit is overwhelming bro

[agile swift]

You can probably do your tantibus pr and then you need to delete your fork and and make a new one

[opal mirage]

"Do it" meaning what? Wait til it's on the website

?

[agile swift]

who wrote Do it?

I wrote:

"You can probably do your tantibus pr and then you need to delete your fork and and make a new one
"

[opal mirage]

You said "do your tantibus"

Okay. Well I think I just did the pr for it

[agile swift]

Aka you can probably go trough with your Tantibus PR and then you need to delete your fork and start from scratch

[opal mirage]

Alright well I will stay diligent until this crap is second nature to me. Or at the very least, makes sense to me.

I understand the metadata, scripts are slowly coming to me, but if I'm being honest, the GitHub side of it, I'm very discouraged about.

[agile swift]

Don't worry you did better than lots of other new contributors 🙂

You'll learn everyday a bit more

[opal mirage]

So do I need to do anything else on this one?

[agile swift]

Wait 🙂

[opal mirage]

I can certainly do that

👌👌👌

I'm just hoping I got all the files the right way this time, Learning from last time and adjusting per your suggestions.

[agile swift]

😄

Why are 3/4 of these something with the Aspect but the port is Tantibus

[agile swift]

nope afraid not

look at the files you're adding to portmaster

tantibus and theaspect

[opal mirage]

See this is what ibwas afraid of...

I put tantibus on github desktop directly in documents/github/ portmaster-new/ports

I don't know how they're part of the aspect.

Ugh.. I'm really sorry ceb

[agile swift]

don't worry 🙂

That happeend because you made a branch not of main

but of the aspect

so you made a branch of another branch

instead of the main tree

[opal mirage]

Okay. So this is what you were talking about how I don't have a default-main branch

So do I need to just delete everything and resubmit the aspect as well

[agile swift]

this has nothing to do with the aspect

that was another pull request

[opal mirage]

Ok so aspect is done

It's just tantibus I gotta re do

When tab told me to make a new branch, I must have done it wrong

So did you just put it into main for me?

[agile swift]

you no longer have a main

😄

You only have aspect and another offspring off aspect

[opal mirage]

Okay. So I do need to delete those right?

And fork the main repo

Portmaster/ portmaster-new

[agile swift]

You deleted the tree lol

[opal mirage]

Great visual, brother.

That's what I need more of for real

So it would be best to start fresh?

[agile swift]

There are ways to do it but i have no idea how 🙂

So either research how to go back to main (chatgpt)

or make a fresh fork

[opal mirage]

Okay. So delete yhe repository and fork fresh

So did I download to my computer the wrong thing

[agile swift]

nah

it happened somewhere when branching

or something

or hitting delete somehwere

[opal mirage]

It has all the ports

[agile swift]

yeah

[opal mirage]

Ya

[agile swift]

but a branch

It#s like this you have your main, then you make a branch, work on that and when you'Re finished you go back to main

[opal mirage]

That must have happened when tab told me to make a new branch, I was on the aspect branch, and branched from there

[agile swift]

yeah and somewhere there you made aspect also default branch

and somewhere there you deleted main

[opal mirage]

Yeah no idea how

So for anything github relate do you EVER use browser?

[agile swift]

in the video he also explains how to go into a branch and back to main

[opal mirage]

Or do you do EVERYTHING from desktop

[agile swift]

sure to review stuff 🙂

[agile swift]

I do everything from command line 🙂

[opal mirage]

Can you do that on desktop

[gloomy vault]

We can even do it from the command line

[opal mirage]

That I don't understand or think I should even try to

Gonna ask chatgpt to explain github to me like I'm 5 yo

Okay, so a fork is a clone of the entire repository. A branch is a new project or PORT in our case, and when we're done with commits and changes and I (think) that uts ready, I do the pull request. Then you guys tell me what's wrong or if it's all good.

Sound about right?

[agile swift]

yeah

and you go back to main

then you can do another branch for other stuff wip

but off of main

you can also talk to chatgpt about insecurities 😄

like can i break anything?

😄

[opal mirage]

So when we want to make multiple ports within a cycle of them being put on the website, do we make a branch for each ports filea?

Cause a pull request is just asking you guys to merge my ports folder with your ports folder, addibg my ports Into the main. Is that right?

Once they go on the website do the branches dissappear?

[gloomy vault]

Only if you delete them

[opal mirage]

Hm... so how did I do tiny town defense?

I never made a branch for it right?

[gloomy vault]

no idea

probably did on main

[opal mirage]

What is the correct procedure to put a new port

[gloomy vault]

i usually do it on main, because im lazy and rarely port shit. 😄

[opal mirage]

Once you've forked the main

Can you do more than one port on main within a website update?

Which of those should I do

I don't know why this is going over my head so much. It should be simple for me to understand. But I'm such a visual learner. I need to see some kind of visual diagram of how it works

[gloomy vault]

Yeah, we choose when we want to release new ports

[agile swift]

No

You do branches

If you do it from main you can't do anything else until the PR is finished completely

[opal mirage]

And a pull request if per port or per website update

This is how I learn ceb. 🙂

I know you want me to watch videos and stuff but if you can just answer my questions, I'll get it a LOT quicker. You're obviously not committed to answer any of my questions if you don't want to, though. But it's how I learn

[opal mirage]

So a yes

[opal mirage]

And a no.

I think klops misunderstood what I was asking

[gloomy vault]

I think so

You can submit one port per PR

We choose when we release the ports

[opal mirage]

I'm asking as a person adding ports, like me, say I wanted to put in 4 games in one day. I'd need to make 4 branches for each game Individually.

You can't do 4 ports from the main in one day. Is that right?

[agile swift]

Yeah but we're not here to hold your hand through each problem. I'm not asking you questions if I'm stuck right? I go do research or I try to make a new environment where I can break stuff

[agile swift]

No you can not

[opal mirage]

I know ceb. You don't have to answer any of my questions. You've already done so much for me

[gloomy vault]

I use chatgpt to figure out git, for the most part i just do basic shit... once something goes wonky i ask chatgpt.

[opal mirage]

So klops, can you explain pull request on my side? Is it something I do per port, or is it per website update? Per branch?

[gloomy vault]

1 minute

[opal mirage]

No problem

I'm sure in a month from now if I looked back at this conversation, I'd say "wow I was an idiot.''

[gloomy vault]

Deepseek is thinking

[opal mirage]

Pull requests from cgpt said is per branch

So per port in other words. Once I've got all the metadata and everything needed, I pull request. Then if it's got issues, we go through revisions and commits, until you guys are satisfied

[gloomy vault]

>>> Can you explain github, branches, and submitting a pull request to a project? In this context we are porting g
... ames to linux handhelds, we require that each game/port be a single branch per pr. The person in question who
... i need to explain this to is a novice and doesnt understand how the branches work in relation to a pull reques
... t.

---

<think>
Okay, I just got this query from someone explaining GitHub, branches, and submitting pull requests in the
context of porting games to Linux handhelds. They mentioned each game/port should be its own branch per PR.
Hmm.

First off, they’re dealing with software development, specifically porting games. That’s probably a
non-trivial task, especially for someone new who doesn't understand how branches and PRs work in GitHub. So
I need to break it down simply.

They mentioned that each game/port should be its own branch per PR. Maybe they're concerned about keeping
things organized so that when one PR is merged into the main branch (like the master), all changes are
rolled out without conflicts. That makes sense because porting might involve a lot of changes and
dependencies.

I should start by explaining what GitHub is, but briefly—no need to go too deep. Then move on to branches
since they’re fundamental here. I'll explain that a branch is like a copy of the main codebase with specific
changes. Maybe use an analogy someone can relate to, like a forked repository having their own version.

Pull requests are next. PRs let contributors submit changes without merging them into the main branch
immediately. It’s a way to get feedback and make sure everything works before integrating it. So explaining
that a PR is a request for changes makes sense. Maybe give an example of submitting a fix after a merge
request to show how they interact.

Then, when porting games, each PR should have only one game/port. That helps prevent issues if multiple
people work on the same project at once or if there are unexpected dependencies between them. By keeping
each branch separate for each PR, it's easier to track progress and manage changes without conflicts.

I also need to make sure they understand why having a single branch per PR is beneficial—maybe touch upon
how this helps in collaboration, rolling out updates smoothly, and managing the codebase efficiently over
time.

So putting it all together: explain GitHub basics, branches as copies with customizations, pull requests for
submitting changes, and then tie it back to porting games by emphasizing the need for organization and
isolation of each PR.
</think>

Sure! Let me break this down in a simple way.

What is GitHub?

GitHub is a platform where developers share code (like your game), collaborate on projects, and manage
features. Think of it as a space where you can upload files, create repositories (which are basically
folders for storing code), and have other people contribute to or pull from that repository.

What is a Branch in GitHub?

A branch is like a "snapshot" of your project at a specific point in time. Imagine you're taking a photo
of your garden; each branch represents the state of your project after you've made some changes.

For example:

• You start working on your game and make some changes.
• You decide to save your progress by creating a new branch (like "version1").
• Later, you realize you want to experiment with something else, so you create another branch ("version2").

Branches help keep your work organized so that if something goes wrong, you can go back to a previous
version easily.

What is a Pull Request?

A pull request (PR) is a way for someone else to propose changes to your project. It's like suggesting
improvements or fixes and asking the community (or the lead developer) to review and approve them before
they become part of the main project.

Here’s how it works:

1. Someone suggests changes in a PR.
2. The person managing the project reviews these changes.
3. If everything looks good, their PR gets "merged" into the main branch (which is often called the "master"
   or "main" branch).
4. After merging, all those changes are now part of your main project.

Porting Games to Linux Handhelds

In the context of porting games to Linux handhelds, you’re essentially creating a version of the game that
runs on a small computer (the Linux handheld). Each game or feature you port should have its own branch
because:

• Each PR represents changes for one specific game or feature.
• Keeping each game or feature in its own branch makes it easier to manage and review without conflicts.

How It Works

1. Branch Creation: You start by creating a new branch (e.g., "g1") when you begin working on the first
   version of your game.
2. Submit Changes: Make all your changes to this branch.
3. Create a Pull Request: Once you’re done with your changes, create a PR so others can review and
   approve them.
4. Merge into Main Branch: If approved, someone will merge your PR into the main branch (e.g.,
   "master"), adding those changes to your game.
5. Repeat for Other Games/Features: For each new game or feature you port, start with a new branch.

Why This Matters

By assigning one branch per PR and ensuring each PR corresponds to only one game or feature:

• It helps keep your project organized.
• Makes it easier to track progress for each individual game or feature.
• Reduces the risk of conflicts when multiple people are working on different parts of the project at the
  same time.

This structure ensures that everyone is working on the right version of the project and can easily see
what’s been done for each specific game or feature.

Hopefully that helps

😄

[opal mirage]

Wow.

Absolutely spot on

Thank you so much. I didn't realize you could be THAT SPECIFIC with an AI

That helped A LOT

[gloomy vault]

Gotta know how to ask stuff

[opal mirage]

So in regards to me somehow deleting my MAIN fork? Or branch?

I need to start fresh by deleting the repository fork completely after this next website update?

[gloomy vault]

Yeah probably

[opal mirage]

Is that the simplest way?

[gloomy vault]

I would probably recommend that.

[opal mirage]

Okay. It's slowly making sense

Thank you for your patience

Seriously

[gloomy vault]

Eh

you're taking the effrort to learn

so i dont mind

[opal mirage]

So this new port tantibus, will NOT be on the next update

But The Aspect will

Right?

Since I somehow added my tantibus stuff to my "the-aspect'' branch

I did tantibus from my github desktop so I'm kinda co fused how I did that. But I'm assuming it's because like ceb said, I do not have a MAIN branch AT ALL. so when I Pushed to Origin, it went to my default branch, which I guess is ''the-aspect''

Klops,

You should add that to #🛠｜your-first-port

Also this

Step-by-Step Guide to Adding a Game to PortMaster (No Command Line)

1. Fork the PortMaster Repository
   Since you can’t edit someone else’s GitHub repository directly, you need to create your own copy:

Go to the PortMaster GitHub repository.
Click the Fork button (top right corner).
This creates a copy of the repository under your own GitHub account.
2. Create a New Branch for Your Game
In your forked repository, click on the "Branch: main" dropdown.
Type a new branch name, like "add-my-game", and click Create branch.
This keeps your changes separate from the main code until you're ready to submit them.
3. Add Your Game’s Files
Now you need to add the necessary files to the repository.

A. Navigate to the Correct Folder
In your repository, look for a folder named something like "games/" (or another appropriate location).
Open the folder and click "Add file" > "Create new file".
B. Add Game Metadata
If the repository requires a configuration file (e.g., JSON or YAML), create a new file like "my-game.json".
Example content for the file:
json
Copy code
{
"name": "My Awesome Game",
"slug": "my-awesome-game",
"platforms": ["Linux", "Windows"],
"install_script": "install.sh",
"launch_command": "mygame --start",
"dependencies": ["libSDL2", "libOpenGL"]
}
Click "Commit changes" to save it.
C. Upload Game Installation & Launch Scripts (If Needed)
If the game needs an installation script, click "Upload files" and select the required files from your computer.
Example files to upload:
install.sh (installation script)
README.md (optional, describing how to install or run the game)
Once uploaded, click "Commit changes".
4. Test Your Game in PortMaster (If Applicable)
If PortMaster has a testing system (such as running the game in a local version), check if everything works as expected.
If you need help, refer to the PortMaster documentation for testing guidelines.

5. Submit a Pull Request to PortMaster
   Now that your game files are in your branch, you need to request that the PortMaster team review and merge them.

Go to your forked repository on GitHub.
Click on the "Pull requests" tab.
Click "New pull request".
In the dropdowns, make sure:
Base repository: PortMaster (original repo)
Base branch: main (or the appropriate branch in PortMaster)
Compare: your branch (e.g., "add-my-game")
Write a clear description explaining what your game is and why it should be added.
Click "Create pull request".
6. Address Feedback & Get Approved
The PortMaster maintainers will review your submission.
They might request changes—if so, you can go back to your forked repository, edit files, and commit them again.
Once approved, your game will be added to the official PortMaster repository!
Summary of the Process Without Command Line
Fork the PortMaster repository.
Create a branch for your game.
Add files (game metadata, installation scripts, etc.).
Test if the game runs properly.
Submit a pull request for review.
Make changes if requested and get it merged.

https://tenor.com/view/animated-greeting-card-hello-friend-gif-16659187900408634093

Hi tab

But ESPECIALLY yours @gloomy vault

[gloomy vault]

what?

[opal mirage]

Mines got some stuff in there like with the json, that might be confusing

[dusky bluff]

honestly, I think it's more important for people to conceptually grasp git -- i think your issues stem from not understanding it (like in a way you could draw a diagram, or something). following steps is fine ... until it isn't, and that's why the conceptual grasp is vital. anyhow, that's my opinion

[opal mirage]

I was saying what you showed me, thats really good information. You should add it to #🛠｜your-first-port

[gloomy vault]

Nah

its quite wrong in places

😄

[opal mirage]

Well you guys would know

Yours is?

[gloomy vault]

Yes

[opal mirage]

Uh oh

[gloomy vault]

FOr you its fine

[opal mirage]

Okay....

Lol

[gloomy vault]

you understand enough to ignore the bits that dont apply

but someone new would get confused by some of the stuff it says

[opal mirage]

Is this correct?

[gloomy vault]

still needs to be merged

[opal mirage]

But The Aspect will be?

Aspect is good to go though?

[gloomy vault]

Yes

[opal mirage]

Thank god

But fir tantibus, because it's in the aspects branch, I should just wait til website update, delete my fork and start over

[gloomy vault]

https://github.com/PortsMaster/PortMaster-New/releases/tag/2025-02-09_0212

its available.

[opal mirage]

Just not updated on the website quite yet

[gloomy vault]

Nah that all happens in time

[opal mirage]

Okay

[gloomy vault]

Same with the announcement

[opal mirage]

So I could delete my fork now or wait til website updates

[gloomy vault]

wait for this port

<_<

[opal mirage]

Ok

I'll wait till I SEE the aspect ON the website

[gloomy vault]

no

until you see tantibus

[opal mirage]

Then I will try to start from scratch by deleting all my repositories and forks

Oh I thought it was messed up because ceb said it's part of the the-aspect default branch

So I DONT have to re submit Tantibus' files?

[gloomy vault]

Hrmmm

<_<

I am not sure now

[opal mirage]

Yeah....

Lolol

Well if you figure it out, let me know

[agile swift]

In tantibus he added aspect files aswell lol

So yeah best start from scratch

[gloomy vault]

too late now

[opal mirage]

I deleted the repository and re forked

I now have a branch "Main" now

[gloomy vault]

okay now make a branch for Tantibus

[opal mirage]

Okay. I'm not at my oc right this moment

But here's the thing, I have the github desktop

And i have tantibus at documents/github/portmaster-new/ports

So I need to learn how to do this on the desktop version

[agile swift]

Yes sir

I believe the video you watched did exactly this, work with github desktop and created a branch 🙂

[opal mirage]

Okay thanks

I wish it worked like you have the portmaster-new-ports folder. You could add your game files and push that to the original. Then you look at the files. I think it's sort of like that, but a branch just keeps it separate from everything right? It's like its own little folder saying "this Is a new port that i want to merge to the portmaster-new/ports folder" and when I put the files in, push to origin, then I do the pull request. Sound right?

[agile swift]

Imagine you have one master word document.
You wish to add some stuff for something new but it should not affect the original. So you make a copy of that document, you add stuff and once you'Re finished you print it out and submit it.

But your original is still intact.

So now that you're done you go back to your main document and now you fetch the latest updates from the main source and so your main document gets updated with the lastest changes

And as long as your copy is still wip you can make another copy of your master document to work on yet something different again

[opal mirage]

Okay, chatgpt was using this analogy but with a coloring book

It makes sense to me as a whole, buy I think because we're adding individual games, with their own individual files, it kind if throws me off. Rather than adjusting one big document, we're adding an entirely new port

And as chatgpt said, each ported game, is always a new branch off of the "default-main"

[agile swift]

yep

until it is merged

once its merged it part of the of main

but our main

and your main needs to be updated with the latest changes

[opal mirage]

Yes. But then it goes away once its merged, because it doesn't need to exist anymore

Which is fetching, right?

[agile swift]

yeah

[opal mirage]

Ok

[agile swift]

when you are on your repo it will say 15 commits behind or something

this means your main is oudated and missing pakages that have been submitted meanwhile

[opal mirage]

So oull requests are only done once you think you've gotten everything in that needs to be there for a port, for you guys to check before merging, right?

[agile swift]

so before you do any work you want to always sync your main to be on par

[agile swift]

yes

[opal mirage]

Okay cool!

[agile swift]

and if something is not right then you go back to your branch do the changes and it'll appear automaticvally in your pull request

[opal mirage]

And AFTER a pull request, and issues are found, once they're fixed, its automatic, I don't have to pull request again.

You basically answered that, bit I wanted to just finish what I was typing. Haha

[agile swift]

yeah

[opal mirage]

I get it

[agile swift]

once its merged and issus occur you have to makje a new pull request

[opal mirage]

Oh what? So if you merged it on accident, and later find issues, I'm notified to fix them, do so, then have to do another fresh pull request?

[agile swift]

We merge it not you 😛

But happens that we miss stuff too

so

[opal mirage]

I know, i said so if YOU merged it on accident

[agile swift]

you make a new branch called fix_stuff, make the changes, make a pull request witht he title fix xy, and the descritpion what you fixed and make a pr

[opal mirage]

Okay, so it won't show up back as something I can go in and edit like I'm able to before it's merged? I need to provide a new branch, put the files back in, with the fixes, and pull request?

[opal mirage]

Or I have this wrong?

[agile swift]

yes

else that would be a huge security risk 😛

[opal mirage]

I understand! I just learned more in these last 30 messages back and forth than in 3 days

[agile swift]

Because you answered your own question with your question lol

[opal mirage]

Well... I learned! That's all that matters! Right?

I just want to again, thank you @agile swift and @gloomy vault and @dusky bluff for everything you've done. The time you've taken to help me understand. It means a great deal to me and it's people like you, that are making this whole PM community better, bigger, and more accessible to people. Thank you!

One more question though, do I need to be placing my port projects within the cloned repository on my computer? Or is that just there as a copy of the portmaster-new database at the time I downloaded it, and if I want to have a copy of it on my own computer, I can?

Or when I press FETCH, does whatever has been updated or changed on the main repo, get downloaded and added to my PC at the documents/github/ portmaster-new location every time?

[agile swift]

once you switch to a branch the folder is a a differnet one

once you switch back to main your changes will remain in that branch

when you sync your main repo everything that has been changed upstream will be downloaded to your main

and synced

hence the name sync

[opal mirage]

Right.

So when I make this first new branch, I'll need to see where it's being saved on my computer so I know.

And those branch folders stay locally on my computer I'm guessing unless I actually delete them myself, unlike the branch being uploaded to the github desktop or web browser that are erased after merge?

[agile swift]

You stopped asking chatgpt did you

Because these questions you can asnwer yourself...

[opal mirage]

Haha. Sorry. I will ask it

Okay

[agile swift]

I'm not your personal tutor 😄

[opal mirage]

I know you're not. But you ARE a wealth of knowledge that I am very grateful for

Answer is Yes. 😉

[rigid pulsar]

Are you sure

[opal mirage]

He's sure

He's been so helpful

[opal mirage]

Okay I just resubmitted tantibus. If I did that correctly, I get it now.

@agile swift @gloomy vault @dusky bluff

[opal mirage]

Was this done right?

[dusky bluff]

there's a p.r waiting, yes. you're waiting on reviews https://github.com/PortsMaster/PortMaster-New/pull/1281

[opal mirage]

So a few more people have to look at I and approve, right?

I'm actually understanding it!

[gloomy vault]

found a small issue

😄

[opal mirage]

Oh boy... what is it. I can edit it

[gloomy vault]

check the pr

so smol

Like, tiny typo

[opal mirage]

Rodl

Rofl

Taitbus

Tanitbus

[gloomy vault]

Otherwise looks good

From what i can see

[opal mirage]

So on the browser version. If I just click commit suggestion, it takes your suggestion and fixes it rright?

[gloomy vault]

Yep

[opal mirage]

So I don't need to go in and edit anything

[gloomy vault]

Correct

[opal mirage]

Just click commit suggestion and it's fixed

[gloomy vault]

Yeppers

[opal mirage]

Okay. Done

Ceb and I had a great back and forth last night and it all came I to view

Him just answering my questions for me and now I think for the most part it makes sense

[opal mirage]

@agile swift @gloomy vault I just fixed a mistake on the .json in this and commited to Main Branch. I think I did the URL beginning and ends right if one of you wouldn't mind checking

[gloomy vault]

send me a link

to where to look

otherwise just PR the fixes?

[opal mirage]

https://github.com/NotYourAveragePaladin/PortMaster-New/blob/main/ports/tantibus/port.json

I "edited in place"

[gloomy vault]

what

o_o

you added a newline at the end?

[opal mirage]

https://github.com/PortsMaster/PortMaster-New/pull/1337

I went to fast and deleted it and I was trying to go off what I saw at the beginning. Please edit it as needed roflmao

[agile swift]

And then you need to make a PR

else it will just sit in your repo

and i hope you made a branch lol

[gloomy vault]

edit in place creates a branch

[agile swift]

i think it asks you

[gloomy vault]

lmao

[agile swift]

https://tenor.com/view/glare-scowl-annoyed-ron-swanson-parks-and-rec-gif-4601682

[opal mirage]

it asked if i wnated ot merge to main or create a branch

i clicked merge toi main

so i creatd a pull request, did i do it wrong

i did it form my phone

[agile swift]

yes, always branch

ALWAYS branch 😄

I thought you knew that by now lol

[opal mirage]

i thought that was for nrew ports only

here let me try to do this form my desktop now

[agile swift]

any change whatsoever

because now you can't do any more ports until that change from main is merged

every branch comes from main

so if you have anything in main any branch is affected you create

[opal mirage]

well shit

lesson learned

waiting for Sunday 🤣 @gloomy vault

i thnk i just did it right it seemed pretty straight forward to me

i gotta stop doing things on my phone. ever.

just be patient and wait til i get to my laptop

its so much easier

[agile swift]

well it asked you if you want to do a branch

automatically!

[opal mirage]

i know i know...

i know now always branch NO MATTEr WHAT

this was a very valuable learnign experience since i am now forbidden to add JACK til sunday

Porting Prison as it will

[opal mirage]

let me know if i did it correctly this time from my desktop

[agile swift]

well you make a pr, write that you fix a json and then also add a library without telling why

Normally I would decline that pr now

[opal mirage]

add a library?

every chance i had to explain what i was doing, i did

on the commit, the PR, and in the PR Text box

Updated .json to match a R2R port and removed the "extract and add files to gamedata" portion as this is a R2R port.

[agile swift]

you added libspeex.so.1

[opal mirage]

i can re do it if you want me to ceb

[agile swift]

https://github.com/PortsMaster/PortMaster-New/pull/1338/files

[opal mirage]

oh my god wtf

[agile swift]

lol

[opal mirage]

i forgot all about that i added it to tantibus as well

its fo rknulli users

its needed for VXAce games on knulli apparently

well i guyess this was a good thing! caus ei totally forgot to even commit tantibus as well. i only did it for painted heart

i think...

does panted heart show that i added libspeex.so.1 too?

or do i need to re do that?

i see it

its been added

im sorry i didnt mention why the library was added. i had completely forgot

and i tested muos and rocknix and that libspeex.so.1 does not affect the game wokring on those

👍

[agile swift]

btw @opal mirage if something is ready to run you just write ready to run in the instructions

because people may still think you need to dwonload it if you put the download link in there