dycall 0.0.8

ℹ About

DyCall is a cross platform GUI application which lets you call exported functions from platform-native libraries.

"libraries" refers to dynamic libraries (a.k.a shared objects etc.).

⚡ Features

• 🔎 Follows platform-specific library search order.
• 🧹 Automatic export name demangling for native libraries.
• #️⃣ Support for ordinal-only exports.
• ↪️ Support for out variables.
• 💡 Find out export names for non-native libraries as well.
• 🛠 Standalone demangler for native ABI mangled names.
• 🔆 Light and dark themes.
• 📜 Multi-lingual interface. Currently only Hindi and Marathi are supported.

🚲 Getting Started

DyCall requires Python 3.7+ with Tkinter installed.

Install via pip:

python -m pip install dycall

You can run it via:

python -m dycall-gui

You can also install shortcuts (Windows and Linux only):

python -m desktop-app install dycall

This will create shortcuts in Windows start menu or an equivalent place on Linux. You can then run DyCall like any other app, pin it, etc.

To uninstall, first remove any shortcuts if you installed them:

python -m desktop-app uninstall dycall

Then uninstall DyCall via pip:

python -m pip uninstall dycall

▶ Usage

The interface has changed a bit since I recorded this GIF

❔ FAQ

1️⃣ Is it non-blocking?

Yes! Function calls are executed on a separate thread. Although, you cannot close DyCall while a function is running. I don't think that's possible.

2️⃣ How do I pass nullptr or NULL as an argument?

Select Type as void

3️⃣ How do I pass Win32 data types?

Win32 data types are just typedefs to basic C data types.

Use this table below for finding out the correct type to use:

Win32	DyCall
PCSTR, LPCSTR	char*
PWSTR, LPCWSTR	wchar_t*
BYTE	uint8_t
WORD	uint16_t
DWORD	uint32_t
HANDLE	void*

4️⃣ How to pass out variables?

There are no special data types for out parameters, just pass them as normal types, the changed values will be reflected after execution finishes.

5️⃣ How to pass a buffer for an out string?

When using OUT Mode for strings, please ensure that none of the arguments are overwritten to a value whose size/length is greater than that before calling; i.e. input argument size must be equal to or greater than output argument size. If this is not the case, you can fill the out argument value with random data of length you know for sure is greater than what the out string will have. Since DyCall has no mechanism to preallocate string buffers, attempts to read beyond the NULL character will result in memory violation errors and crash DyCall.

6️⃣ How to find an ordinal-only export?

Ordinal-only exports have names starting with an @ followed by the ordinal number.

7️⃣ I want to add/update a translation

Check the Adding Translations section in the contributor's guide.

🚀 Roadmap

• Automatic call convention detection.
• Function prototype detection from header files or similar.
• Use a child process to execute, this ensures more stability.

🤝 Contributing

Please check the contributor's guide.

You can contribute by adding translations, opening issues and filing pull requests. If that cannot be an option for you, you can directly drop an email. All contributions are welcome and acknowledged.

Contributors should also take a note of the Code of Conduct.

© License

DyCall is distributed under the MIT License. See LICENSE for more information.

📧 Contact

E-mail: demberto@protonmail.com

🙏 Acknowledgments

• FlatIcon
• Best-README-Template
• Shields
• Keep A Changelog

Additional acknowledgements have been made in the code.