Carnival

Menu

• Brief
• Features
• Support for TTY
• Compilers
• C Standard
• Build
• DevLog
• Trouble Shooting

Brief

A friend project to: [Jungle - Study - Java] written in C. More supplies towards GNU/Linux and Microsoft® Windows™.

Features

• Date & Time calculator
• Powerful Scheduler
• Todo list with its programmable language
• Alarm clock
• Text editor (TUI version of Que)
• Music player

Specials

• TUI Windowing
• Graceful
• Customisable
• Impressive to use on first, impossible to get rid of it later on. :)¹
• Has features above ;)²

Support for TTY

Carnival's output is simply ASCII³ (TUI). However, colouring is not strictly required, which as an compatibility for non-colourable terminals.
For TTY, our first priority, we do provide basic rendering on most terminals.

Compilers

In code, we tried to make Carnival more compatible with different compilers.
In current stage, it's mainly supported by:

• GCC
• MinGW

Please note, unlike what we did previously, Carnival is now assembled with those compilers' support.
That means, you could have used your compilers to build this project and execute the result regardless about what your compilers are as long as they are in support. :)¹

C Standard

In Carnival, we use C99⁴ standard.

Hardware requirement

For Carnival, the minimum bit width for CPU is 16 bits. As the architecture , use 8086 for the most "proper" performance.⁵

Build

Please be aware, if you want to use your own compiler, then you need to check file "config.sh" first, in order to set proper environment variables.

0. Configure

   • Edit config.sh until satisfied. :)¹

1. Compile

   cd Carnival && make

2. Done

   Enjoy! Xhe xhe.

   • Run for Unix-like:

     ./build/Carnival

   • Run for Windows

     .\build\Carnival.exe
     

     or

     #MOUSE CLICK x2#
     

DevLog

[6th Mar, 2023]
Due to project code responsibility allocation controversial issue, previous "Carnival" or "Carnival_MinGW" and "Carnival_GNU" are found ambiguous to be continued on development.
Thus, we created a new repository for dividing job responsibility, for Carnival, for all.

We will not change our original promise in file README from previous storage.
Here they are:

[31st Jan, 2023]
Carnival is currently in development, this project will roughly go on the stage with polish in about 6 more months(in the worst scenario).

For development, Carnival is now divided into two parts for multi-platform performance.
They are:

• Carnival_MinGW
• Carnival_GNU

The MinGW one is obviously majorly for Windows;
The GNU one is yet again, apparently mostly for GNU/Linux;

BTW, if you'd like to have C/CXX compilers on Android, there's my project Attraction (Early development stage). If there were any questions, please contact via e-mail at "[email protected]". I might not be reply in time, thank you.

[2nd Jul, 2023]
Delayed due to unforeseeable causes, major progress isn't affected.
Dependencies were increased, more work has to be put in.
I have no companionship on developing this project, please contact me if you got any questions.

Trouble shooting

Q0: What license does this project hold?
A0: GPL 3.0

Q1: What does this project do?
A1: It's currently unemployed.
A1: I mean, it could help users with following:

• Date & Time calculator
• Powerful Scheduler
• Todo list with lang...

A1: Didn't I just declared all these in section Features?
A0: Yep.

Q2: Can I modify this project?
A2: Yes, you can. :)¹
$~~~~~~$ But, only to improve. ;)²

Q3: What is ASCII?
A3: Thank you, that will be all.

Q4: How do I blackmail ya? 😈 $~~~~~~~~~~~~~~~~~~~~$ . o O ( pls don't )
A4: "[email protected]" 😅

Q5: There were no matching questions here with mine.
A5: Well, you can always put up an issue to ask. :)¹

Q6: How many faces drawn in ASCII are there?
A6: Segmentation fault (core dumped)

Footnotes

1. A smiling face drawn in ASCII. :)¹ ↩ ↩² ↩³ ↩⁴ ↩⁵ ↩⁶

2. A smiling winking face drawn in ASCII. ↩ ↩²

3. Not the final decision. We are willing to use Unicode in the short future. ↩

4. ISO/IEC 9899:1999 ↩

5. However, it is far too early to conclude about what architecture to use could get the "best" performance to this very project. Besides, we haven't even start profiling to this project. Thus, what the line said was all in a theoretical hypnosis. :( ↩