muOS-এ অ্যাপ ইনস্টল: Archive Manager দিয়ে .muxapp ও .muxzip ফাইল

muOS-এর অ্যাপ আসে .muxapp দিয়ে শেষ হওয়া একটি ফাইল হিসেবে। এটি আনজিপ করতে বা ফোল্ডার কপি করতে হয় না: muOS-এ Archive Manager নামে একটি ইনস্টলার আছে যা কাজটা করে দেয়। এই গাইডে পুরো প্রক্রিয়া, ভেতরে কী হয়, আর যে দুটি জিনিসে লোকে আটকে যায় সেগুলো দেখানো হয়েছে: আপডেটে সেটিংস রিসেট হয়ে যাওয়া, আর আনইনস্টল করার উপায়।

পরীক্ষিত: Anbernic RG40XXH · muOS 2601.0 Jacaranda। অন্য muOS হ্যান্ডহেল্ডেও একইভাবে কাজ করে।

.muxapp ফাইল কী

.muxapp ফাইল আসলে ভিন্ন শেষাংশের একটি সাধারণ ZIP আর্কাইভ। ভেতরে অ্যাপের নামে একটি ফোল্ডার থাকে, যেমন:

WiFiTransfer.muxapp
└── WiFiTransfer/
    ├── mux_launch.sh    ← muOS এটি দিয়ে অ্যাপ চালায়
    ├── config.ini
    └── …

ইনস্টল মানে সেই ফোল্ডারটি SD কার্ডের MUOS/application/-এ খুলে রাখা। ওই ফোল্ডারের প্রতিটি অ্যাপ Applications মেনুতে দেখা যায়।

ধাপ ১: ফাইলটি ARCHIVE ফোল্ডারে কপি করুন

Archive Manager SD কার্ড 1-এর (যে কার্ড থেকে muOS চলে) একদম ওপরের ARCHIVE ফোল্ডারের ফাইলগুলো দেখায়। ফোল্ডারটি না থাকলে বড় হাতের অক্ষরে বানিয়ে নিন।

ফাইলটি সেখানে রাখার তিনটি সহজ উপায় আছে:

কার্ড রিডার: হ্যান্ডহেল্ড বন্ধ করে SD কার্ড 1 কম্পিউটারে লাগান আর .muxapp ফাইলটি ARCHIVE-এ কপি করুন। খোলার আগে ঠিকভাবে ইজেক্ট করুন।
Wi-Fi দিয়ে Wi-Fi Transfer ব্যবহার করে: হ্যান্ডহেল্ডে অ্যাপটি খুলুন, এটি যে ঠিকানা দেখায় তা ফোন বা পিসির ব্রাউজারে খুলুন, আর SD card 1 ট্যাবে Add games চেপে .muxapp বেছে নিন। এটি আপনা থেকেই ARCHIVE-এ যায়।
SFTP: muOS একটি SFTP সার্ভার চালাতে পারে: Configuration → Connectivity → Web Services-এ SFTP + Filebrowser চালু করুন। এরপর যেকোনো SFTP অ্যাপ (FileZilla, Cyberduck, WinSCP) দিয়ে ফাইলটি SD কার্ড 1-এর ARCHIVE-এ কপি করা যায়।

ফাইলের নাম যেমন আছে তেমন রাখুন: Archive Manager শেষাংশ (.muxapp) দেখে ঠিক করে কী করবে।

ধাপ ২: Archive Manager দিয়ে ইনস্টল করুন

হ্যান্ডহেল্ডে Applications → Archive Manager খুলুন।
.muxapp ফাইলটি বেছে নিয়ে A চাপুন।
কাজ চলার সময় muOS মেনু বন্ধ করে একটি টেক্সট স্ক্রিন দেখায়: Inspecting Archive…, খোলা হতে থাকা ফাইলগুলো, Sync Filesystem আর শেষে All Done!
কয়েক সেকেন্ড পর আপনি Archive Manager-এ ফিরে আসবেন। ফাইলটির পাশে এখন INSTALLED লেখা থাকে।

Applications খুলুন: নতুন অ্যাপটি তালিকায় আছে। কিছু অ্যাপ চালু করার আগে Wi-Fi চালু করতে হয় (Configuration → Connectivity → Wi-Fi Network)।

ইনস্টলের পরেও .muxapp ফাইলটি ARCHIVE-এ থেকে যায়। ব্যাকআপ হিসেবে রাখতে পারেন বা মুছে ফেলতে পারেন; ইনস্টল করা অ্যাপের এটি লাগে না।

Archive Manager আসলে কী করে

কিছু খোলার আগে Archive Manager আর্কাইভটি যাচাই করে, আর ভেতরের কোনো পাথ যদি লক্ষ্য ফোল্ডারের বাইরে যায় (একটি পূর্ণ পাথ বা ..), তাহলে ইনস্টল করে না। তাই নষ্ট বা ক্ষতিকর প্যাকেজ এভাবে muOS-এর সিস্টেম ফাইল বদলে দিতে পারে না।

এই যাচাই ফাইলের জায়গা নিয়ে, অ্যাপ চালু হওয়ার পর কী করে তা নিয়ে নয়। muOS-এ অ্যাপ সিস্টেমে পুরো অ্যাক্সেস নিয়ে চলে, তাই শুধু বিশ্বস্ত উৎস থেকে .muxapp ফাইল ইনস্টল করুন: ডেভেলপারের নিজের ওয়েবসাইট বা GitHub-এর রিলিজ পেজ।

Archive Manager শুধু অ্যাপের জন্য নয়। ফাইলের শেষাংশ দেখে এটি ইনস্টলের পদ্ধতি বেছে নেয়:

শেষাংশ	কী	কোথায় যায়
`.muxapp`	অ্যাপ্লিকেশন	`MUOS/application/`
`.muxthm`	থিম	`MUOS/theme/<নাম>/`
`.muxalt`	বর্তমান থিমের বিকল্প চেহারা	সক্রিয় থিমের ফোল্ডার
`.muxzip`	কনটেন্ট প্যাকেজ (ভেতরে যা আছে তার ওপর নির্ভর করে সেভ, BIOS বা কালেকশন)	মিলে যাওয়া muOS ফোল্ডার
`.muxcat`	ক্যাটালগ প্যাকেজ (বক্স আর্ট ও বিবরণ)	`MUOS/package/catalogue/`
`.muxcfg`	RetroArch কনফিগারেশন প্যাকেজ	`MUOS/package/config/`
`.muxupd`	muOS সিস্টেম আপডেট	সিস্টেম নিজেই

অ্যাপ আপডেট: আগে সেটিংস সেভ করুন

আপডেট করতে নতুন .muxapp ফাইলটি ARCHIVE-এ কপি করে একইভাবে ইনস্টল করুন। Archive Manager এটি বিদ্যমান অ্যাপ ফোল্ডারের ওপরে খোলে:

নতুন প্যাকেজে যে ফাইলগুলো আছে সেগুলো পুরোনোগুলোকে বদলে দেয়, config.ini-সহ;
প্যাকেজে যে ফাইল নেই, যেমন অ্যাপের data/ বা logs/ ফোল্ডার, সেগুলো থেকে যায়।

তাই অ্যাপের config.ini-তে আপনি যা বদলেছেন, আপডেটের পর তা ডিফল্টে ফিরে যায়। আপডেটের আগে অ্যাপের config.ini নিরাপদ জায়গায় কপি করে রাখুন (বা সেটিংসগুলো লিখে রাখুন), তারপর আবার বসিয়ে দিন। তবে Game Manager ব্যতিক্রম: এর প্যাকেজে config.ini নেই, তাই আপডেটের পরেও আপনার itch.io API কীসহ সেটিংস থেকে যায়। আপনার ইনস্টল করা গেমের তালিকা data/-এ থাকে আর আপডেটের পরেও থেকে যায়।

নতুন ফাইলের নাম পুরোনোটির মতো হলে আগে ARCHIVE-এর পুরোনো ফাইলটি মুছে ফেলুন বা বদলে দিন, যাতে কোনটি ইনস্টল করছেন তা নিশ্চিত থাকে।

অ্যাপ আনইনস্টল করা

muOS 2601-এ অ্যাপ আনইনস্টলের কোনো বোতাম নেই। সরাতে হলে এর ফোল্ডারটি মুছে ফেলুন:

SD কার্ড 1 → MUOS/application/<অ্যাপের নাম>

কার্ড রিডার, SFTP বা Wi-Fi Transfer দিয়ে এটি করুন। তারপর মূল মেনুতে ফিরে আবার Applications খুলুন; অ্যাপটি আর নেই। ফোল্ডার মুছলে অ্যাপের নিজের সেটিংস ও ডেটাও মুছে যায়, তাই যা রাখতে চান আগে কপি করে নিন।

সমস্যা হলে

Archive Manager “No Archives Found” বলছে: ফাইলটি SD কার্ড 1-এর ওপরের ARCHIVE-এ নেই, বা ফোল্ডারের নাম ভুল। এটিকে ARCHIVE হতে হবে, ROMS বা MUOS-এর ভেতরে নয়।
ফাইলটি তালিকায় আছে কিন্তু “unsafe paths” বলে ইনস্টল হচ্ছে না: প্যাকেজটি ভুলভাবে বানানো। অ্যাপের ডেভেলপারের সঙ্গে যোগাযোগ করুন; হাতে খোলার চেষ্টা করবেন না।
“Could not open archive… Corrupt?”: ডাউনলোড পুরো হয়নি বা কপি মাঝপথে থেমে গেছে। আবার ডাউনলোড করুন, আর ডেভেলপার SHA-256 চেকসাম দিলে মিলিয়ে দেখুন (Mac বা Linux-এ shasum -a 256 file.muxapp)।
অ্যাপ ইনস্টল হয়েছে কিন্তু দেখা যাচ্ছে না: মূল মেনুতে ফিরে আবার Applications খুলুন। তবুও না থাকলে দেখুন MUOS/application/<অ্যাপের নাম>/mux_launch.sh আছে কি না।
অ্যাপ চালু হয়েই বন্ধ হয়ে যায়: অনেক অ্যাপ নিজের ফোল্ডারে একটি লগ লেখে, সাধারণত logs/app.log। সেটি দেখুন, আর অ্যাপের ইন্টারনেট লাগলে Wi-Fi চালু করুন।

সংক্ষেপে

.muxapp ফাইলটি SD কার্ড 1-এর ARCHIVE-এ রাখুন।
Applications → Archive Manager, ফাইলটি বেছে নিন, A চাপুন, All Done!-এর জন্য অপেক্ষা করুন।
Applications থেকে অ্যাপটি খুলুন।
আপডেটের আগে অ্যাপের config.ini সেভ করুন। আনইনস্টল করতে MUOS/application/-এ এর ফোল্ডার মুছুন।

প্রশ্ন থাকলে ইমেইল করুন feedback@pocketkode.com-এ।

PocketKode-এর সঙ্গে muOS বা Anbernic-এর কোনো সম্পর্ক নেই।